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Introduction 


The HP 48 Handbook is designed with the programmer in mind — 
a concise combination of system descriptions and detailed 
reference information. The HP 48 Handbook is not intended to be 
a replacement for the Owner's Manuals — which cover the 
interactive applications and calculus subjects not treated herein. 


Organization. The first chapters cover the organization of the 
system, object manipulation, and how programs work. The next 
chapter discusses the HP Solve Equation Library application 
card, with both operation and reference information. The 
remaining chapters provide reference tables for flags, messages, 
units, and so on. 


The Subject Index lists the commands by subject areas to 
provide another way to rapidly find the right command for a 
particular application. The Command Reference contains the 
complete set of stack diagrams for every command in the HP 48. 


Fundamental Concepts. The HP 48 world revolves around the 
stack, which is implemented as a dynamically allocated last —in- 
first-out (LIFO) structure which can hold any number objects of 
different sizes and types (see Objects, Names, and Constants). 
All commands take their (zero or more) arguments from the stack 
and return any results to the stack. For instance, consider the 
following display: 





Level 1 contains the number 2.47, level 2 the algebraic expression 
57 +X’, and level 3 the complex number (3,4). 
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Now execute the multiply function. While multiply is executing, 
the arguments are removed from levels 1 and 2, leaving (3,4) in 
level 2. When the multiplication is complete the result is returned 
to the top of the stack: 


HOME 


i 
4 
3 
"3 
1 


(3,4) 
CSP +A) #2.40' 
PaRTS| PROE | Wve [MATR[VECTR 





Many commands are type-sensitive, that is, they perform 
different operations for different types of input parameters. For 
the complete descriptions for each command, see Command 
Reference. 


Example Programs. There are several example programs and 
program fragments in this book. Each complete program is 
named and printed with a size and checksum. 


All characters in the programs are case-sensitive. The names of 
commands are always uppercase. By convention, the names of 
global variables are uppercase, and of local variables are 
lowercase. 


While the command line entry of a program may be free form, 
with the keystroke being valid between words, graphics 
objects must be entered exactly as shown, with no extra breaks in 
the command line when entering the data. 


If you enter a program into the HP 48, use the BYTES function to 
make sure the program in the calculator matches the version in 
the book. For instance, the program « DROF SWAP = is 15 
bytes long and has the checksum #5197h. The sizes for named 
programs include the size of the program name. 
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Objects, Names, and Constants 


Object is a general term for anything that can be put on the stack 
or stored in a variable. Any object may be described in terms of 
its type and value. For instance the number 247 has type "real 
number" with value 247. 


Objects may be classified into several broad categories: 


e A data object contains information, such as a number or a 
sequence of characters. Real numbers, complex numbers, 
binary integers, arrays, and strings are examples of data 
objects. 


e A procedure object is a collection of objects that perform a 
task in order. Programs and algebraic expressions are 
procedure objects, and may be evaluated, placed on the 
stack or stored in variables just like any other object. 


e Aname object permits an object to be referenced by name. 


O Global names refer to corresponding variables that 
are available at any time. By convention, global 
variable names are written in uppercase (A). 


O Local names refer to corresponding local variables 
that exist only with the scope of the executing 
program that defines them. By convention, local 
variable names are written in lowercase (3). 


e Acomposite object is an object which is made up of one or 
more objects. Unit objects, lists, tagged objects, and 
programs are examples of composite objects. 


In general, objects may be stored in variables or manipulated on 
the stack regardless of their type. Some HP 48 functions and 
commands perform different operations based on the type of 
object supplied as a parameter. For instance, the + function 
executes differently for strings (concatenates) than for real 
numbers (adds). 
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Object Evaluation 

Evaluation of an object may be either implicit or explicit. Objects 
being entered on the command line, such as a real number or the 
name of a command such as _ +, are implicitly evaluated unless 
surrounding delimiters delay evaluation. An object on the stack 
may be explicitly evaluated by executing EVAL . 


Evaluation results vary with the type of object: 


When a global variable name is evaluated, the contents of 
the variable are evaluated. To place a global variable name 
on the stack, enclose it in tick marks ('%'). 


When a local variable name is evaluated, the contents of the 
local variable are recalled to the stack, but not evaluated. If 
a local variable contains a real number, the behavior is 
essentially the same as for a global variable, but if the local 
variable contains a program, the program will only be 
recalled to the stack. You can use a subsequent EVAL to 
evaluate the program. 


When a program is evaluated, global names are evaluated 
unless surrounded by ticks ('), the contents of local names 
are recalled to the stack, commands are executed, and all 
other objects are put on the stack. 


When an algebraic object is evaluated, the value it 
represents is computed and returned to the stack. 
Algebraic objects being evaluated obey rules of precedence 
— see the table on the next page. 


When a list is evaluated, global names are evaluated, 
programs are evaluated, commands are executed, and all 
other objects are put on the stack. 


All other objects are put on the stack. 
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Operator Precedence 

Operator precedence controls the order in which calculations 
take place within an algebraic expression. Functions with the 
highest precedence (1) are evaluated before those with the lowest 
precedence (11). The evaluation order is left-to-right for 
operators having the same precedence. For instance, in the 
expression '3+5+#7', the multiply operation takes precedence 
over the add, resulting in the answer 38, whereas the answer 
would be 56 if evaluated from left to right. 


Expressions within parentheses 
Functions 

| (factorial) 

Power (*) and square root (/_ ) 
Negate (—), multiply (*), divide (/) 


Add (+) and subtract (-) 
Relational operators 
(==,4<,>,52) 

AND and NOT 

OR and XOR 

Left argument for | (where) 
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Object Types 

Different object types may be distinguished in the stack display 
through their delimiters — characters that are unique to that type 
of object. For instance, strings are surrounded by quote marks 
("), and programs are contained in French quotes (#=). 


HP 48 objects are identified as follows: 


Real number 
Complex number 
String 


1.2345 
to. ay 4, a 
u AEC" 


Real array 

Complex array 

List 

Global name 

Local name 

Program 

Algebraic 

Binary integer 

Graphics object 

Tagged object 

Unit object 

XLIB name 

Directory 

Library Library Fee: . 
Backup object Backup HO MEDIR, 
Built — in function SIH 

Built — in command SAP 

Library Data Library Data 





Related Commands: TYPE returns the type of object in level 1. 
VTYPE takes a variable name and returns the type of object in the 
variable, or —1 if the variable doesn't exist. TVARS takes a type 
number and returns a list of variables of that type in the current 
directory. 
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Real and Complex Numbers 


Real Numbers. Real numbers have a 12-digit mantissa between 
1 and 9.99999999999 and a 3-digit exponent between -— 499 and 
+499. During math operations, real numbers are expanded to 
have a 15-digit mantissa and a 5-digit exponent during the 
calculation, then rounded back to the 12-digit value when 
returned as results. 


Complex Numbers. Complex numbers are represented by pairs 
of real numbers in parentheses: (2,3) (1.2,5). The Rectangular 
(X,Y) and Polar (r,6) display modes (flags -15 and -16) control 
the appearance of a complex number on the stack, but do not 
affect the internal form. For instance, (2,3) is displayed in polar 
form as (3.60555127546, 4.56.309932474). 


Vectors and Matrices. Vectors and matrices may be composed 
of either real or complex numbers. Some examples: 


Cie Real vector 
[C12] Real matrix 
C3 4]] 

COC ¢i,4> €1,29 Complex matrix 


C ¢€2,19 €2,;2) J] 


Related Commands: The commands R-C and C-—R convert 
between real and complex numbers or real and complex arrays. 
C—R, V—, and OBJ— decompose a complex number to its real 
and imaginary parts. C—R separates a complex array into an 
array of real components and an array of imaginary components. 
OBJ— separates a complex array into a series of complex 
numbers followed by a list containing the dimensions of the 
original array. If Complex Mode (flag —19) is set, -V2 creates a 
complex number. 
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RE returns the real component of a number or array; IM returns 
the imaginary component. ARG returns the polar angle 6 of a 
coordinate pair (x,y). SIGN returns a unit vector in direction of the 
input argument (x,y). 


Binary Integers 
Binary integers are entered and displayed with a leading # 
delimiter and a trailing b, d, h, or «oto indicate the base. 


Examples: #181161b #247%d #7DACh 


The commands STWS and RCWS may be used to store or recall 
the wordsize, which may be up to 64 bits. The wordsize controls 
the interpretation of arguments and the results of arithmetic 
operations. For instance, if a binary integer is added to a real 
number, the real number is truncated to the current wordsize, and 
the result is a binary integer truncated to the current wordsize. 


TRUTH TABLE 


arg, arg, 
AND OR 





Related Commands: The following commands are useful for 
working with binary integers: AND, B—>R, NOT, OR, RCWS, RL, 
RLB, RR, RRB, RB, SL, SLB, SR, SRB, STWS, and XOR. 
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Unit Objects 

Unit objects are entered and displayed in the form: number_units 
where number is a real number and units is an algebraic 
expression containing unit names, prefixes, exponents and the 
operators #, “,and ~*~. (A unit object may only contain one 
operator.) During conversions, unit powers are rounded to 
integers MOD 256. 


Examples: 


Units in Menus. Unit objects in built-in menus or custom 
menus provide three types of functionality: 


e Primary keys append the unit on the key to the numerator of 
the level 1 object. 


e Left—shifted keys convert to the level 1 object to the unit on 
the key. 


e Right—shifted keys append the unit on the key to the 
denominator of the level 1 object. 


User-Defined Units. A user-defined unit may be created from 
any combination of the built-in units or other user-defined units. 
To create a user-defined unit, store the definition in a variable 
whose name is the name of the new unit. 


For example, create the user-defined unit week by storing 7_d in 
the variable week. Executing UBASE on 2 week yields 
1209600 s. The object 1 week stored in a custom menu will now 
behave like any other unit — related menu key. 
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Photometric Units. The numerical values of lumen (Im), lux (Ix), 
phot (ph), and footcandle (fc) include a factor of 1/4 (steradian). 
To convert between these units and candela (cd), footlambert 
(flam), lambert (lam), or stilb (sb), do one of the following: 


e Divide the expression including steradians by sr, the 
dimensionless unit for steradians, or 


e Multiply the expression not including steradians by sr 


Related Commands: The following commands are useful for 
working with unit objects: CONVERT, OBJ—, UBASE, UFACT, 
— UNIT, and UVAL. 


Backup Objects 

Backup objects are used to store backed-up data in 
independent memory (ports 1 or 2) or in port 0. A backup object 
may contain any object, including directory structures. 


Backup Identifiers. The contents of a backup object are 
referenced by a backup identifier (eg: :1:FFEL), which is a 
port—tagged name. 


The wildcard # may be used for the port number for the 
commands RCL, EVAL, and PURGE. When the wildcard is 
evaluated, memory is searched in the order of ports 2, 1, 0, and 
then main memory for the first occurrence of the specified name. 


If a backup object contains a directory structure, an object within 
that directory structure may be recalled or evaluated by 
specifying the path and name of the object in a port—tagged list. 
For instance, :1:< EEDIR FRED 3 refers to the object FRED in 
a directory stored in backup object EEDIR in port 1. 
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Creating Backup Objects. A backup object is created by 
executing the STO command with the object in level 2, and the 
port—tagged name in level 1. For instance, the sequence 
'FRED' RCL :1:BFRED STO recalls the contents of variable 
FRED to the stack and creates a backup object called BFRED in 
port 1. 


Recalling Backup Objects. The contents of a backup object 
may be recalled in two ways: 





2, then 


(>) and the menu key for the backup object. 


e Place the backup identifier on the stack and execute RCL. 


Evaluating Backup Objects. The contents of a backup object 
may be evaluated in two ways: 
e Press [#4] (LIBRARY), FORTS, PORTI, or PORT for the 
port number, then the menu key for the backup object. 


e Place the backup identifier on the stack and execute EVAL. 
EVAL also accepts a list of backup identifiers. 


Purging Backup Objects. To purge a backup object, place the 
backup identifier on the stack and execute PURGE. A backup 
identifier may be included in a list supplied to PURGE. 


Related Commands: PVARS takes a port number as its 
argument and returns two results: 
e Level 2 contains a list of backup objects and library IDs. 


e Level 1 contains the type of memory in the port - 
"SYSRAM", "ROM", or a number showing the amount of 
available independent RAM. 
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Library Objects 

Library objects are collections of one or more objects that 
generally extend the built-in command set. Libraries are 
referenced by a /ibrary# or a library identifier ( : port#: library# ), 
depending on the command. The title of the library may be 
displayed by pressing [4] in the LIBRARY menu. 


Installing a Library. Library objects only extend the command 
set when they are stored in a port (0, 1, or 2) and attached toa 
directory in user memory. To use a library, perform the following: 


e Store the library object in a port, such as port 0. For instance, 
if the library object is in level one of the stack, execute 0 STO. 


e Turn the calculator off, then on again. The calculator will 
perform a_ system halt, which updates the system 
configuration to recognize the new library. 


e Attach the library to the desired directory. 


O To attach a library to the current directory, enter the 
library# and execute ATTACH. 


O To detach a library from the current directory, enter the 
library# and execute DETACH. 


Note: some libraries will automatically attach to the HOME 
directory. Any number of libraries may be attached to HOME, but 
only one library may be attached to each subdirectory. 


Removing a Library. To purge a library, perform the following 
steps: 


e Ensure that the library object does not appear on the stack 
as Library mmm: ... Either store the library in a 
variable or execute NEWOB to create a unique copy. 


e If the library is attached to the HOME directory, enter the 
library#, suchas :2:272 and execute DETACH. 


e Enter the library ID, suchas :2:272 and execute PURGE. 
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Variable Names 

Variable names may contain letters, digits, and most characters. 
Names may not start with a digit, match a command name, or 
contain object delimiters or the characters + - # ¢ * J = ¢ 
> £2 # 4 Sf ! space, comma, or@. 


Reserved Variables. The HP 48 stores information for various 
commands in reserved variables. Reserved variables may reside 
in any directory, and may be used in more than one directory at a 
time. 


| Name | Cescription 
ALRMDAT Current alarm editing data 
CST Custom menu contents 
EQ Current equation for SOLVE and PLOT 
IERR Uncertainty of integration 
IOPAR 1/O parameters 
PICT References the graphics display 


PPAR PLOT parameters 

PRTPAR PRINT parameters 

Cer... User-defined derivatives begin with der 
ni, n2, ... Integers created by ISOL 

$1, S2, ... Signs created by ISOL and QUAD 

XDAT Current statistical matrix 

=PAR Statistics parameters 





Notes: 


e The [4] SETUF menu only modifies the copy of 
IOPAR in the HOME directory. 


e The print commands only modify the copy of PRTPAR in the 
HOME directory. 


e PICT is not directory— dependent. It only refers to graphics 
display memory. 


Objects, Names, and Constants 13 


Symbolic Constants 
The HP 48 has five constants which may be used in symbolic 
form or as approximate numerical values. 


i 
MAR 
MIHR 





System flags -2 and -3 control evaluation of symbolic 
constants: 






Flag Description Clear Set Default 


Symbolic Math Flags 


Symbolic Constants Symbolic form Numeric form Clear 
Numeric Results Symbolic results | Numeric results Clear 
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Memory Organization 


Memory in the HP 48 is accessed in four-—bit quantities (nibbles, 
or 1/2 bytes) within a 20-bit address space, yielding a 512K byte 
address space. The BYTES command, which returns the size 
and a checksum for an object, will sometimes show a size such 
as 106.5, reflecting that the object occupies 213 nibbles of 
memory. 


System Memory 


Memory in the HP 48 is organized as follows: 


System ROM The operating system resides in 256K bytes 
of read only memory (ROM). This command 
set may be extended through the use of 
library objects which reside in ROM or RAM 
(see Library Objects). 


System RAM There are 32K bytes of random access 
memory (RAM). Slightly less than 32K is 
available as user memory, as the rest is 
devoted to display memory and reserved 
system scratch and pointer memory. 


Plug-in ROM Plug-in ROM application cards, such as the 
HP 82211A HP Solve Equation Library, may 
extend the built-in command set. 


Plug-in RAM HP 48SX RAM may be extended by adding 
plug-in RAM cards that contain either 32K 
(HP 82214A) or 128K (HP 82215A). Plug-in 
RAM may be configured two ways (see 
below). 
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Configuring RAM Cards 
Initial Configurations. Before a plug-in RAM card is used, 
some consideration should be given to its intended use. RAM 
cards may be configured two ways: 


e Independent RAM may be thought of as an "electronic 
disk", which may be removed from the calculator. Individual 
objects or entire directories may be placed in independent 
RAM (see Backup Objects for more details). This 
configuration is most suitable for backing up data, "hiding" 
data from the HOME directory, or exchanging data with 
another calculator. 


Merged RAM extends the built-in RAM, creating more 
room for variables and directories, temporary objects, or 
graphics display area. To use a card in this manner, enter 
its port number and execute MERGE. Merged RAM may 
not be removed from the calculator unless the FREE 
command is used to free it. To free a card, make sure there 
is enough available memory to hold all your variables 
(including the contents of port 0), enter a blank list in level 2, 
the port number in level 1, and execute FREE. 


Changing Configurations. A merged RAM card may also be 
"converted" to an independent RAM card containing objects that 
were in port 0. To do this, enter a list containing the objects to 
transfer to independent RAM in level 2, the port number of the 
card in level 1, and execute FREE. 


The reverse operation is also possible. An independent RAM card 
may be converted into merged RAM with the MERGE command. 
Any objects that were in the card will appear in port 0. 


Understanding Port 0. Port 0 is a portion of built-in memory 
(which may include merged RAM cards) which behaves in the 
same manner as an independent RAM card (except that it is not 
removable). Port 0 may contain either library or backup objects. 
The amount of memory devoted to port 0 changes as objects are 
stored in it or purged from it. 
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User Memory 

User memory may be organized into a tree structure of directory 
objects, which are implemented as variables stored in the HOME 
directory. 


HOME 
x Y  PROGS IOPAR EQNS DATA 
PROG1 PROG2 PAGES PROG1 QUAD 
P41 P2 


The status line displays the current directory path, and the VAR 
menu displays the current directory: 





In the example above, the current directory is PAGES, which 
contains variables P1 and P2. 


Creating a Directory. A directory may be created with the 
command CRDIR. To store variables in the new directory move 
to the new directory by evaluating its name or pressing the 
corresponding key in the VAR menu. 
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Accessing Variables. When a variable name is evaluated, the 
current directory is searched first. If the variable is not found, its 
parent directories are searched in ascending order until the 
variable is found. In the example above, there are two variables 
named PROG1. Different directories may have variables of the 
same name. 


Changing Directories. To change to a lower directory, simply 
evaluate its name. To return to the previous level, execute UPDIR 
(see Menu Traversal Program). Evaluating a list that starts with 
HOME followed by directory names can quickly change the 
current directory to any other place in user memory. For 
instance, if the current directory is PAGES, evaluating { HOME 
EQNS } will change the current directory to EQNS. A port- 
tagged path may be used for RCL and EVAL, but you must move 
to the target directory for STO. 


Changing a Directory Name. To change the name of a directory 
or move the directory to another location, perform the following 
steps: 


e Recall the directory to the stack 

e Purge the old directory 

e Move to the new location 

e Enter the new name and execute STO. 
Purging a Directory. The PURGE and PGDIR commands may 
be used to purge a directory. The PURGE command only 


removes empty directories; PGDIR removes a directory and its 
contents. 


Saving User Memory. The commands ARCHIVE and RESTORE 


may be used to save and recover all of user memory (see Data 
Transfer). 
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Temporary Memory 

The data stack in the HP 48 is actually a stack of pointers which 
refer to objects elsewhere in memory. Temporary memory is the 
calculator’s "scratchpad". All objects that are not stored in a port 
or in a user variable reside in temporary memory. Many 
commands require temporary memory to construct intermediate 
objects or new objects returned as results to the stack. 


Use of Temporary Memory. To understand temporary memory 
a little more, consider what happens when two math operations 
are perfomed. Enter the numbers 1.5 and 2.6 on the stack. 
These numbers now reside in temporary memory, referred to by 
pointers on the data stack. When the numbers are added, the 
result, 4.1, is a number in temporary memory referenced by a 
pointer in level 1 of the data stack. The objects 1.5 and 2.6 
remain in temporary memory, referenced by pointers that save 
the Last Arguments. 


Now add 2.8 to the result in level 1. The level 1 pointer on the 
data stack refers to the object 6.9 in temporary memory. The last 
arguments pointers now refer to the objects 2.8 and 4.1, and the 
objects 1.5 and 2.6 are no longer referenced. 


Garbage Collection. From time to time the HP 48 will "hesitate" 
during an operation. This hesitation is usually caused by the 
removal of objects in temporary memory which are no longer 
being used. Objects which are no longer referenced continue to 
accumulate in temporary memory until memory has been filled. 
When memory is full, the calculator scans the objects in 
temporary memory, deleting those without references to them. 
This process, known as "garbage collection", is similar in concept 
to garbage collection in LISP. 


A large number of pointers on the stack that point to temporary 
memory can slow down the garbage collection process to an 
uncomfortable degree. This occurs when there are a large 
number of objects on the stack, or an object has been extracted 
from a large list. List operations can be optimized by storing the 
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lists in global variables, effectively moving the operations from 
temporary memory to user memory. 


The MEM command returns the amount of available memory, 
forcing an initial garbage collection to return an accurate result. It 
may be helpful to insert the sequence MEM DROP to force 
garbage collection prior to speed — sensitive program sequences. 


The NEWOB Command. The command NEWOB may be used 
to create a new copy of an object in temporary memory, whose 
only reference is on the data stack. In general, the system will 
perform an automatic NEWOB where it make sense. For instance, 
if you recall the contents of a variable to the stack and press 
[EDIT], the object will be copied to temporary memory before 
editing begins. 


There are two uses for NEWOB: 


e NEWOB "frees" an object that was extracted from a list. 
Consider the following program: 


"oe "et "EPH * = GET ‘S 


Level 1 of the data stack contains a pointer into the list, 
which still resides in temporary memory. Executing 
NEWOB now would create the unique object "AB" in 
temporary memory, and release the list for garbage 
collection. Note: set the Last Arguments flag (-—55) to 
prevent the list from being references as a last argument. 


Recalling an object to the stack simply returns a pointer to 
the data stack. To purge a backup object from a port while 
retaining a copy in temporary memory, recall the object and 
execute NEWOB. Then the original object may be purged 
because there are no references to it. 
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Graphics 


The HP 48 display is a 131x64 pixel LCD which may present the 
stack or PICT, a portion of memory set aside for graphic displays. 


Graphics Coordinates 
Two systems of coordinates may be used to manipulate P/CT and 
graphic objects: 


User units, represented as complex numbers, are typically 
used to define the boundaries of plots. The first two entries 
in PPAR store the coordinates of the lower—left corner and 
upper-right corner of PICT. The default plot boundaries 
are (-6.5,-3.1) and (6.5,3.2).User-—unit scaling 
information is stored in the reserved variable PPAR. 


Default User Coordinates 


(-6.5,3.2) (6.5,3.2) 





(-6.5,-3.1) (6.5, -3.1) 


Pixel coordinates are represented by a list containing two 
binary integers, { #col #row}. Graphics objects on the 
stack may only be described with pixel coordinates. The 
upper — left pixel is represented by { #0 #0 }. 


Pixel Coordinates 


{ #0 #0}, { #130 #0 } 





GOR coordinate F_] 


{ #0 #63 } O { #130 #63 } 
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Graphics objects added using GOR, GXOR, or REPL are located 
by their upper-left corner using either user or pixel coordinates. 
Note: the sequence PICT { #0 #0} grob REPL is faster for 
animation than grob PICT STO. 


Related Commands: The commands C-PX and PX—C convert 
between user—unit and pixel coordinates based on the 
dimensions in PPAR. The PDIM command changes the size of 
PICT. 


CPX Command 
User —unit to pixel coordinate conversion 

(xy) — {#col #row } 
PDIM Command 
Changes the size of P/CT. 

(XminxYmin) (Xmax¥max) — Changes PICT relative to the 
current user coordinates 
#horizontal #vertical — Does not affect current 
user coordinates 

PMAX Command 
Sets the upper-right plot coordinates 

(sy) — 
PMIN Command 
Sets the lower —left plot coordinates 

(sy) — 
PX—C Command 
Pixel to user —unit coordinate conversion 

{ #col #row} — (x,y ) 
SCALE Command 
Specifies x and y scale in units per 10 pixels 
x yo 





Other commands that affect scaling are AUTO, AXES, DEPND, 
INDEP, *H, and *W. 


22 Graphics 


Stack 


View Program 


The following stack-view program STKV displays up to ten levels of 
the stack simultaneously. The display mode, plot parameters, stack 
values and graphics picture are preserved. The system remains 
halted until ATTN is pressed, after which the program resumes to 
restore the original PPAR and PICT. 


STKV 371.5Bytes Checksum #A1B7h 


* IF o 


os ‘T RCL FPRFAR + pict pear 


x PI 
1 
1 
Le 
TH 


ELS 


EH 


EPTH THEM 


CT PURGE 
32 ARHG 1 64 VRHG 
DEPTH 1 - 18 MINH DUP 


o + 


EH 6 1 
rE = 


a] 


ray 


OC + rowht tsize 


#* FOR i PICT 1 i rowht 


EHD 


Graphics 


# ReC RCLF STD i 
": "4 SHAP STOF 
+ PICK +STR + 
*GROB GOR 


> PYIEH 
‘PPAR PURGE pear 
IF 'PFAFR' SANE WOT 
THEH pear 'PRPAR' STO 
EMD 
Fict PICT STO 


Make sure stack is not empty 
Preserve original PICT and PPAR 
Purge original PICT 

Set new X and Y ranges for stack 
Determine current stack height 
If greater than 8, text row height 
is 6 and text size is 1 

Otherwise, text row height is 8 
and text size is 2 

Loop for the no. of stack levels: 
Use STD display mode to 

build stack level identifier 

Add stack value to identifier, 
and add to picture 

End loop 

Display PICT, wait for [ATTN] 
Purge new PPAR 

Did PPAR exist before? 

Yes, store old value 


Restore original PICT 


: TAG: 
oA a é4 _gg0000000000000000 





GROB Structure 


A graphics object is structured as follows: 


header 


length 


height 


width 


data 


<header> <length> <height> <width> <data...> 


This is a five—nibble* field that distinguishes a 
graphics object from any other object type, and has 
a fixed value of #02B1Eh. 


This field is a five—nibble quantity that contains the 
distance in nibbles from start of length field to the 
nibble past the end of the object. This length is #Fh 
+ the number of data nibbles. 


This field is a five—nibble quantity that specifies the 
height of the graphics image in pixels. 


This field is a five—nibble quantity that specifies the 
width of the graphics image in pixels. 


The data nibbles begin at the upper-left corner of 
the graphics object and proceed left-to-right, 
top-to-bottom. Each row must contain an integral 
number of bytes, so the data may be padded with 
garbage bits. The bits in each nibble are written in 
reverse order, so the leftmost displayed pixel in a 
nibble is represented by the least— significant bit of 
the nibble. 


If you are preparing a graphics object on a personal computer, 
remember that the HP 48 CPU reads data from memory into registers 
in reverse order, so the first four fields are written backwards. For 
example, the header is written E1B20. 


* A nibble is 1/2 byte. 


24 


Graphics 


Graphics objects may be entered into the command line on the 
HP 48. To enter a blank graphics object, type GROB width height, 
where width and height specify the size in pixels. 


Examples: To enter a graphics object which represents "G" in the 
small font, type GROB 4 5 E010D090E0 . 





On a personal computer, the graphics object looks like this: 


E1B20 B1000 50000 40000 E010D090E0 
header length width height data 


In the second example consider a blank graphics object that is the 
size of the display with the "G" from above in the upper-left corner. 
The graphics object looks like this on a personal computer: 


E1B20 header 
F8800 length 
04000 height 
38000 width 


EQO0000000000000000000000000000000 row7 
1000000000000000000000000000000000 row2 
DOO0000000000000000000000000000000 row3 
QO00000000000000000000000000000000 row4 
EQO0000000000000000000000000000000 rowd 
ODDDDDDD00000000000000000000000000 rowé6 
... 2176 total data nibbles see 
OODDDDDDDDDD00000000000000000000000 row 64 
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The fields for the example on the previous page are derived as 
follows: 


e The display width is 131 columns = 83h pixels, or 17 bytes or 
34 nibbles. 


e The display height is 64 rows = 40h pixels. 


e The data length is bytes — per—row x rows = 2176 nibbles. The 
length field is calculated as 2176 + 15 = 2191d = 88Fh. 


PPAR 


The reserved variable PPAR (which may exist in every directory) 
contains scaling information and plot specifications. 


PPAR — 
{ (Xmin. Ymin) (max Ymax) indep resolution (Yaxis: Paxis) Ptype depend } 


renee [town | 


(min Ymin) | Lower-left pixel coordinates 
(Xmax Ymax) | Upper—right pixel coordinates 
indep Independent var for horizontal axis 
resolution Real positive integer for user —unit point spacing, or 
binary integer for pixel spacing (0O=every column). 
Specifies the bar width for BAR plots or the bin 
width for HISTOGRAM plots. 
Axes intersection coordinates (0, 0) 
Plot type: FUNCTION, CONIC, POLAR, BAR, FUNCTION 
PARAMETRIC, HISTOGRAM, SCATTER, TRUTH 
Dependent variable Y 
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Statistics Data 


Data used by the STAT application resides in or is named by the 
reserved variable SDAT. Statistics data may be entered from the 








matrix can be stored in ZDAT using the (4) (STAT) NEW” 
command. The command EDIT: may be used to edit SDAT using 
the MatrixWriter. 


Append one data point with one coordinate value 





Reverses the effect of the last 5+ 








[ Xy Xp.» Xm J Append one data point with m coordinate values 
(l Xoy ++» Xam J 

ies Append n data points with m coordinate values 
[Xq1 +++ Xam J] 


XDAT Statistics Matrix 


Coordinate Number 
4 
Xi4 


Data Point 


2 3 
X12 X13 
Xoo Xog 
Xao Xgg 


Xr2 | Xa 
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PAR 

The reserved variable SPAR contains plot and scaling information. 
Each directory may contain a unique ZPAR. The entries for the 
independent and dependent columns may be set using the COLD 
command. 


ZPAR — 


{ indep dep intercept slope model } 


[Pwnoer [onion =a 


indep Independent column number 


dep Dependent column number 
intercept Intercept of current regression model 
slope Slope of current regression model 0 
model Current model: LINFIT, EXPFIT, PWRFIT, LINFIT 
or LOGFIT 
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Data Transfer 


Any named object, such as a variable, backup object, or 
complete directory, may be transferred to another HP 48 or a 
computer. A complete backup of user memory may also be 
transferred to another HP 48 or a computer. 


Pathways 
There are three methods of transferring data between the HP 48 
and another HP 48 or computer: 


Objects may be transferred between HP 48s using the 
infrared (IR) link. The IR link is fixed at 2400 baud, no parity, 
and may be used to transfer data in either ASCII or binary 
mode. 


Objects may be transferred between a computer and an 
HP 48 using the serial (wire) link. The wire link may be 
configured to support a variety of baud rates and parity 
options. The Kermit protocol provides the most reliable 
transfer mechanism. 


Plug-in RAM cards may be configured as independent 
memory and exchanged between HP 48s. The commands 
FREE and MERGE are used to configure RAM cards. Only 
library and backup objects can reside in independent 
memory. 
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Kermit Protocol 

The Kermit file transfer protocol ensures correct data 
transmission between two HP 48 calculators or an HP 48 and a 
computer. Kermit was developed at the Columbia University 
Center for Computing Activities. Detailed information about 
Kermit is available in a book by Frank da Cruz, KERMIT, A File 
Transfer Protocol, 1987, Bedford, MA (Digital Press). For 9600 
baud transfers, it’s best to disable the updating clock display. 


Kermit Configurations. Kermit protocol provides two basic 
configurations for data transfer: 


Local/Local Commands must be entered on both machines 
to effect a transfer: a SEND command must be 
issued on the sender, and a RECEIVE (RECV or 
RECN on the HP 48) command must be issued 
on the receiver. New commands must be 
issued for each object transferred. (Some 
implementations of Kermit permit "wildcard" 
characters to send a series of files with one 
command.) 


Local/Server One machine is placed in server mode, which 
acts upon commands received from the sender. 
The server: 


e Transmits an object when it receives a GET 
command with a file name. 


e Receives an object when it receives a SEND 
command. 


e Exits Kermit when it receives a FINISH 
command. 


The server may respond to multiple transfer 
requests without keyboard intervention. 
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Remote Kermit Operation. The HP 48 can respond to several 
Kermit commands when in server mode. These commands 
initiate actions, list variables, or transfer data. 


GET: The Kermit command GET name instructs the HP 48 server 
to transmit the contents of the named variable to the computer. 


SEND: The Kermit command SEND name instructs the HP 48 
server to receive the contents of the named computer file and 
store them in a variable of the same name. 


REMOTE DIR: The Kermit command REMOTE DIR (packet GD) 
causes the HP 48 server to reply with a separate line for each 
variable in the current directory. Each line contains the variable 
name, length in bytes, type, and a decimal checksum. Examples: 


[Rane [enath [Type [ Chekeur 


Real Number 
Algebraic 
CLE St Directory 
IOFAR 29. List 


mi Ts 


EC I. 


Ts 





REMOTE HOST: The Kermit command REMOTE HOST (C 
"host-commanad" packet) may be used to execute HP 48 
commands from the computer. After the command has been 
executed, the HP 48 replies by returning the stack contents. The 
stack is formatted in a manner similar to the PRSTC (print stack 
compact) command. For instance, to add two numbers on the 
HP 48, type "REMOTE HOST 2 3 +". Assuming that the stack 
was empty before, the HP48 replies with the string 
"Li 5s". If the stack is empty, the HP 48 replies Empty 
Sta = ck. 


FINISH: The Kermit command FINISH transmits the GF packet to 


the HP 48 to turn off server mode on the HP 48. The GL packet, 
associated with logout commands, has the same effect. 
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HP 48 —— HP 48 


To transfer an object between two HP 48s, perform the following: 





Set the sender to the directory containing the variables to 
send. 


Set the receiver to the directory that will receive the variables. 


Local/Local Configuration 


. On the receiver, execute RECV to store the incoming variable 


under the sender’s name, or enter a name and execute RECN 
to rename the incoming variable. 


On the sender, enter the variable name and execute SEND. 


Repeat 1 and 2 for each additional variable. 


Local/Server Configuration 


. On the server HP 48, execute SERVER ([p) [170)). 


On the /Jocal HP 48: 


e To send variables to the server, enter the variable name 
and execute SEND. 


e To receive variables from the server, enter the variable 
name and execute KGET. 


After all variables have been transferred, execute FINISH on 
the local HP 48 or press on the server. 


Data Transfer 


HP 48 Computer 
To transfer objects between the HP 48 and a computer, perform 
the following: 





JP menu to set wire transmission 
mode, the baud rate, parity, and checksum settings. 


Set the HP 48 to the directory which will send or receive 
objects. 


Local/Local Configuration 


. Issue the receive command: 


HP 48: Execute RECV or enter the variable name 
and execute RECN. 


or Computer: Issue the RECEIVE command. 
Issue the send command: 


HP 48: Enter the variable name and execute 
SEND. 

orComputer: Issue the SEND _ file—specifier 
command. 


Repeat 1 and 2 for each additional file, then execute 
CLOSEIO on the HP 48 to save battery power. 


Local/Server Configuration 


. Set the server operation: 


HP 48: Execute SERVER ([p?] [1/0)). 
orComputer: Execute the Kermit Server command. 
On the local device: 


e To send a variable, enter the variable’s name and execute 
the SEND command. 


e TO receive the contents of a variable on the server, enter 
the variable name and execute GET or KGET. 


After all variables have been transferred, execute FINISH on 
the local device and CLOSEIO on the HP 48 to save battery 
power. 
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Backing Up the HP 48 
The ARCHIVE and RESTORE commands may be used to save 
and recover the entire contents of user memory on a computer. 


Note: The system and user flag settings may be preserved by 
executing RCLF and storing the flags in a variable. After doing a 
restore, recall the contents of the variable and execute STOF. 


To back up all of user memory to a computer, perform the 
following steps: 
e Connect the HP 48 and the computer. 


e Use the [4] SETUP menu to set wire transmission 
mode, the baud rate, parity, and checksum settings. 


e Optional: Execute RCLF and store the flags in a variable. 


e Enter the object : 10:name, where name is the computer file 
name that will contain the HP 48 image. For 9600 baud 
transfers, it’s best to disable the updating clock display. 


e Issue the Kermit RECEIVE command on the computer. 


e Execute ARCHIVE on the HP 48. 
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Restoring the HP 48 
Caution: The RESTORE command erases the entire contents of 
user memory! 


To restore the user memory image from a computer, perform the 
following steps: 


e Be sure there is enough user memory available to hold the 
incoming file. Since the RESTORE will replace all of user 
memory, you might as well execute CLVAR. 


e Connect the HP 48 and the computer. 


e Transfer the file containing the memory image to the HP 48 
the same way as for any file. 


e Put the file name on the stack and execute RCL. This puts 
Backup HOMEDIF in level 1. 


e Execute RESTORE. 


e Optional: Recall your variable containing the user and system 
flags and execute STOF. 
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ASCII File Transfer 
An ASCII file generated on a computer provides an alternative 
method for entering data or a large program in the HP 48. To 
ensure that the data is interpreted correctly by the receiving 
HP 48, the following header string should be included which 
indicates the expected modes: 

%SHP! T¢translation>A« angle —mode >F «fraction—mark> ; 


The codes are defined as follows: 


See Character Translations 


Sets the angle mode 
Sets the fraction mark 





The HP 48 will ignore text after the @ character at the end of a 
line in the computer file. 


Example: The following text on a computer may be transferred to 
the HP 48 in ASCII mode to create a program that returns the 
area and volume of a sphere given its radius. Notice the use of 
character translations to represent various HP 48 characters: 


42HP: TCSIACDOFC. 3S 
Sid Me Pp std 2 Comment information 


4 \pi S->NUM # fF 2 * # "Area" \->TAG 
4.3 / Spi \->NUM # fF 3 * # "Yolume" \->TAG 
“ab 

“SF 


On the HP 48, the program looks like this: 


€ Fr 
& 47 3HUM * fr 2 * * “Area” +TAG 
43 7 HUM # r 3 * * "Volume" 3TAG 
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Character Translations 

When data is transferred between the HP 48 and a computer 
using translate codes 2 (000-159) or 3 (000-4255), conversions 
are used to represent some characters. 


For data being transferred to a computer with translate codes 2 or 
3, each ~ is replaced with ~~... For data being transferred to the 
HP 48, characters may be converted using a text conversion or 
xxx, where xxx is the three-digit (decimal) character code. 


The following table shows the text conversions for characters 
above code 127. 


NUM HP 48 ASCII NUM HP 48 ASCII 


f 
J 
a 
T 


2 oH Ik Ir. i 
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IOPAR 

The reserved variable JOPAR may only reside in the HOME 
directory. Other variables of the same name in subdirectories will 
be ignored by the |/O commands. 


IOPAR — 


{ baud parity receive-pacing transmit-pacing checksum translate-code } 


= 


1200, 2400*, 4800, or 9600 
parity O=none™*, 1=odd, 2=even, 3=mark, 4=space 
Negative parity value = transmit only 
receive-pacingt | Value #0 sends XOFF if HP 48 buffer full 


transmit-pacingt | Value #0 stops transmission if XOFF received 
checksum 1=1 digit arithmetic, 2=2 digit arithmetic, 3=CRC 
translate-code O=none, 1=LF to CR-LF, 2=128-159, 3= 128-255 


* IR is 2400 baud, no parity only t Not used by Kermit 
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Cables 


The Serial Interface Kits include a serial cable for an IBM- 
compatible personal computer (HP 82208A) or an Apple 
Macintosh computer (HP 82209A), and a copy of Kermit that can 
run on the host computer. 


5 -- RX (input) 
4 -- SGND 


Macintosh end 3 -- TX (output) 





7 -- SGND 


3 -- RX (input) 
2 -- TX (output) 
PC end with adapter | | [ 1 -- SHIELD 


13 

OO OO O3@ OOO. Crore © 
O00 0: 0:0'0O O00 0:9 
25 14 


5 -- SGND 
3 -- TX (output) 
PC end mie eee eo Indy 








Se 
HP 48 cable end | tLe 4 | SHEL 
2 -- TX (output) 
3 -- RX (input) 
4 - SGND 
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Menus 


Custom Menus 
A custom menu may be created using a list of objects supplied to 
the MENU or TMENU commands. 


< Key, Keyo Keys ... 


The objects that define each key in the menu may range in 
complexity from a real number to a list definition with a graphics 
object for the menu key label and separate actions for the primary 
and left— or right — shifted planes. 


The Variable CST. The MENU command stores the definition in 
the reserved variable CST and immediately displays the menu. 
Each directory may have a different variable CST. A name may 
be stored in CST which references a variable containing the menu 
definition. The TMENU command does not affect CST. 


Menu Contents. Menus may contain any object, but the 
functionality of the key is determined by the type of the object: 

e Names work the same way as the VAR menu. 

e Keys with string definitions echo the string. 

e Directory names change to the directory. 

e Unit objects act as unit catalog entries: 


O Primary keys append the unit on the key to the 
numerator of the level 1 object. 


O Left—shifted keys convert the level 1 object to the unit 
on the key. 


0 Right-shifted keys append the unit on the key to the 
denominator of the level 1 object. 


e Backup objects act like the port 0, 1, and 2 menus. 


e Labeled objects can be used to identify menu key actions 
and can provide optional shifted functionality. 
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Labels. A menu key can have a label that is different than its key 
action. The most versatile key definition provides separate 
objects for the label, primary, left—shifted, and right- shifted 
actions. Either a string or a graphics object 8 rows high by 21 
columns wide may be supplied as the label. 


Example: The following list contains a menu definition for six 
keys: a variable, string, unit object, labeled program, a definition 
that uses a graphics object for the menu label, and labeled key 
definition with shifted functionality: 


MENUEX 226.5 Bytes Checksum #C051h 


£ 
in 
"HELLO" 
1_om"s 
{ "PRG" « 2 #3 + # } 
< GROB 21 8 0000000404000A0A0005151080A020FFFFF100F 100004000 
"Kilroy was here!" 


3 


imag Fi os ae 8 
« CPL & primary action 
* 'CPL' STO »*  left-shifted action 
« 'CFL' RCL *  right-shifted action 
3 

3 





Te Ee 
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Menu Traversal Program 

The commands RCLMENU and UPDIR may be used to traverse 
the built-in menu trees as well as the directory tree in the VAR 
menu. This program allows automatic movement from any menu 
to its parent (if one exists) or to the last menu viewed if no parent 
exists (see Menu Numbers). If the parent menu key leading to the 
currently displayed menu is on a page beyond page 1 (such as in 
the UNITS submenus which have parents in pages 1 through 3 of 
the main UNITS menu), this routine will return to the correct 
originating page of the parent. Menu numbers greater than 59 
have the LIBRARY menu as their parent. 


The program is based on a 61 - element list called PARENT. Each 
element rn of the list has the value of the menu number and page 
of the parent corresponding to menu rn for menus 1 through 59. 
The first element accounts for a zero result from RCLMENU. The 
last element accounts for LIBRARY submenus. 


If UP is assigned to [+] , it replaces the normal action of that 
key when the HP 48 is in USER mode. To make this assignment, 
execute UP’ 31.2 ASN . 


PARENT (61-element list) 456 Bytes Checksum #8DB8h 


HHARBSSS33 36 18 16 16 if if iva 
818 GHG 6 24 24 244 8 29 1 31 G 
835 35 37 35 8 40.04 & 42 42 42 42 42 42 
42,02 42,02 42.02 42.02 42.02 42.02 42.05 
42.03 42.03 42.03 42 24 3 


UP 89Bytes Checksum #235Bh 


* RCLMEHU IP 1 + 61 MIM DUP 
IF 2 SAME 
THEN DROP UPDIF 
ELSE PARENT SWAP GET MEHU 
EHD 
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User Keys 


Variables, programs, commands, or strings may be assigned to 
any key on the HP 48. When 1-User or User mode is active, 
these objects are evaluated in place of the standard key 
definitions. 


The ASN and STOKEYS commands may be used to assign an 
object to a key. The command RCLKEYS recalls the current key 
assignments, and DELKEYS deletes one or more assignments. 
These commands are shown on the next page. 


Setting User Mode 

1—User mode may be set by pressing [4] [USR]. 1—-User mode 
remains in effect for only one operation. User mode may be 
locked by pressing [4] twice or by setting flag -62. When 
flag —61 is set (4) toggles user mode, and 1-—User mode is 
not available. 


Key Locations 
The notation rc.p specifies the location of a key where r is the 
row, c is the column, and p is the plane. 


| p | Primary Planes en Alpha Planes 


Unshifted Alpha 


Left — shifted Alpha left — shifted 
Right — shifted Alpha right — shifted 





Examples: the ENTER key is 51.0 (or 51), the PURGE key is 54.2, 
and the alpha right — shifted CST key is 23.6. 


Standard Keys 
When User mode is set, the standard key definitions apply to all 
keys which have not been reassigned. The standard key 
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definitions may be disabled by using supplying the S parameter 
to the DELKEYS command. The symbol S refers to standard key 
definitions. An individual standard key definition may be 
reactivated by supplying SKEY as the assigned object for ASN. 
All standard keys may be reactivated by supplying SKEY to 
STOKEYS. 


Related Commands: 


ASN Command 
Make a single user—key assignment 


object rep — 
"SKEY’ rc.p —+ Reactivates standard key 


DELKEYS Command 
Clears user-key assignments 
rc.p Clears a single key 
{ 'C.p,; fC.po... Clears a list of keys 
Clears standard key definitions 
{ Sre.p, rc.po... Clears list of keys & std key defs 
Clears all user keys 


RCLKEYS Command 
Lists user—key assignments. S indicates standard keys are active. 

— {obj, rc.p, ... obj, rc.p,, } 

—+ {S$ obj, rc.p, ... obj, re.p, } 


STOKEYS Command 


Makes multiple user —key assignments. Including S activates standard 
key definitions. 
Ss - 
{ obj, rc.p, ... Obj, rc.p, } — 
{S obj, rc.p, ... obj, re.p,} — 





Key Assignment Program 

A simple program, = & HAIT ASH %, may be used to assign an 
object to a key. Store the program in a user variable (or assign it toa 
key!). Place the object to assign in level one, execute the program, 
and press the key to be assigned. 
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Programming 


Program Structure 

In the simplest form, a program is a collection of commands or 
functions enclosed by program delimiters (« %). A simple 
example returns the area of a circle given its radius in level 1: 


“£2 ¢ nw +Hlh + & 


Programs which are more involved may use /ocal variables to 
avoid potential conflicts with global variables. The formal syntax 
for programs using local variables is: 


« + local-names defining—procedure * 


Local variables exist in a local environment during execution of 
the defining procedure and take precedence over global 
variables of the same name when evaluated. Values for the local 
variables may be established at the start of the program, prior to 
the +. The defining procedure may be either an algebraic 
expression or a program. 


Example: Suppose the stack contains 3 in level 3, 2 in level 2, 
and 1 in level 1. The following programs produce the same result 
(17) by first assigning the values to local variables x, y, and z: 


Soe oxe yo zz 'CetytzIeetx' 
+ *® yu Zz 
eS oe ee ee + 


When a local variable is evaluated, it only recalls the contents of 
the variable. This is similar to evaluating global names that 
contain data objects. However, if the local variable contains a 
program, it can only be executed by an explicit EVAL. 
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User-Defined Functions 

User-defined functions may be used to extend the function set 
of the HP 48. A user-defined function takes its arguments from 
the stack and must return exactly one result to the stack. The 
arguments may be either algebraic or numeric. 


The syntax of a user-defined function must be exactly: 
« + local—names defining-procedure # 


User-defined functions created with the DEFINE command use 
an algebraic expression as the defining procedure. If the 
defining procedure is a program, the program must remove all 
arguments from the stack and return one real number. 


The DEFINE command simplifies the creation of a user-defined 
function by converting an _ expression in the form 
‘name«arguments>=expression' into a named program that 
consists of a local variable structure and an algebraic expression. 


Example: Create a function POLY(x)=2x?+4x+7. Enter the 
expression 'FOLY¢x2=2#x°2+4#x+7' and execute DEFINE. 
The variable POLY in the VAR menu now contains the program: 


So4¢ ee 'Bee*2+dent+ Pf! 
If the number 8 is in level 1, executing POLY yields 167. 
Assuming that the variable S is undefined, POLY(’S +5’) yields the 
expression '2#¢S+55°2+44¢S4+59+7'. 
Example: Create a function PTHG(x,y)=V x? + y?. Enter the 


expression 'PTHG¢x,;yo=fex*2+y°2>' and execute DEFINE. 
The variable PTHG in the VAR menu now contains the program: 


46 Programming 


Looping Structures 
Program loops are useful for repetitive execution of a procedure. 
There are two general classes of loops: 


e Definite loops execute a loop-—clause at least once, and 
execute a predefined number of iterations. 


e Indefinite loops execute a loop-—clause repeatedly until a 
test-clause returns a true (non-zero) result. One form of 
an indefinite loop may not execute at all if an initial test fails. 


Definite Loops. There are two types of definite loops, both of 
which can have an increment of either 1 or n: 


Start finish FOR index loop-—clause HEXT 

Start finish FOR index loop-clause increment STEP 
start finish START loop-clause HET 

Start finish START loop-clause increment STEF 


In each case the start and finish values are taken from the stack 
and are no longer available to the program. The index is a local 
variable that may be referenced in the loop clause just like any 
other local variable. The increment is also taken from the stack. 
This syntax shows it being put there by the program, but it can be 
calculated also. 


Increment= 1 Increment=n 
Index FOR ... HET FOR ... NSTEF 
No Index 





Programming 47 


The differences are: 


e FOR loops keep their index in a local variable which is 
available to the loop—clause. An early exit may be taken 
from a FOR loop by one of the following two methods: 


O Store MAXR in the index for loops with a positive step. 
O Store —-MAXR in the index for loops with a negative 
step. 


e START loops save memory and execute faster than FOR 
loops for applications where access to the index is not 
needed and the increment will always be 1. 


e Loops ending with STEP may have a varying increment. 
When STEP is executed, the increment is added to the 
index. The loop will repeat under the following conditions: 


O The increment is positive and the index is less than 
the finish value. 


0 The increment is negative and the index is greater 
than the finish value. 


e Loops ending with NEXT execute faster than those ending 
with STEP, because the increment value is always 1. 


Examples: 
* 1 18 START loop-clause HEXT * 
Executes loop —clause 10 times. 


« 1 26 FOR x loop-clause HEXT # 
Executes loop — clause 20 times; x is the index. 


« 1 18 START loop-clause 2 STEP # 
Executes loop — clause 5 times. 


* 1 26 FOR x loop-clause 2 STEP # 
Executes loop —clause 10 times; x is the index. 
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Indefinite Loops. There are two forms of indefinite loops: 


e [0 loop—clause UNTIL test-clause EHD 


DO loops execute at least once. The placement of UNTIL is 
unimportant since the test occurs at the end, but by 
convention is placed between the loop and test clauses to 
improve legibility. 


WHILE test-clause FEFEAT loop-clause EHD 


WHILE loops never execute if the test-clause returns an 
initial false (zero) result. The placement of REPEAT is 
important, as it isolates the test clause, which usually 
executes one time more than the loop clause. 


Loop Counters. The commands INCR and DECR may be used 
at any time to increment or decrement a real number stored in a 
variable. 


The command INCR takes a local or global variable name, 
increments its contents, and returns the new value to the stack. 
For instance, if x contains 23, 'x' IHCF stores 24 in x and 
returns 24 to the stack. DECR behaves the same way as INCR, 
but decrements the variable’s contents. 


Examples: The first program (46 bytes, checksum #FD95h) 
always prints at least one carriage-right, up to the number of 
carriage—rights specified in level 1. The second program (48.5 
bytes, checksum #FEDCh) prints the number of carriage —- rights 
specified in level 1. 


fot x 


* DO x DECRE CR UNTIL « HOT EWD 2 


a os 


* WHILE x REPEAT =» DECR CR EMD > 
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Conditional Structures 


IF Structures. The IF structures perform a test and execute a 
true—clause if the test is true or a false—clause if the structure 
includes ELSE. 


IF 
IF test—clause 
test— clause THEH 


THEM true -clause 
true —clause ELSE 
EMD false —clause 





Example: This program (82.5 bytes, checksum #ACFOh) stores a 
value from the stack into variable a and returns .35*a or .45*a ifa 
> 10. 


IFT and IFTE. IFT and IFTE may be used as as commands, 
taking their arguments from the stack. IFTE may also be used in 
an algebraic expression. 


IFTE<test-—clause, true—clause, false—clause 3 


test-—result 


test—result true —clause 
true —clause false —-clause 
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CASE Structures. The CASE...END structure combines a series 
of IF...THEN structures that ends when the first true condition has 
been met. A "default" clause may be placed before the END 
command which is executed if none of the conditions have been 
met. 


CASE 
test-— clause THEH  true—clause 
test-—clause THEH  true—clause 


test-— clause THEH  true—clause 
default — clause 
EMD 





Example: This program (127 bytes, checksum #A7F1h) accepts 
an object and issues an error for non-real types, executes the 
procedure Xneg for numbers less than zero, Xzero for numbers 
equal to zero, or Xpos in the default case. 


The type for a real number is zero, so a non-real object 
generates a true condition. In this case the command DOERR will 
issue message #202h, "Bad Argument Type". 


+ x 
# CASE 
x TYPE THEH # 262h COERR END 
'x<@' THEM &neg EMD 
'x==8' THEW «zero EHD 
APOS 
EMD 


Programming 51 


Error Trapping 

The IFERR structure is useful for trapping anticipated errors. The 
trap —clause is executed first, and if no error is encountered an 
optional ELSE normal-—clause is executed. If an error occurs 
within the trap clause, the remainder of the trap clause is 
bypassed and the error—clause is executed. Note that the Last 
Arguments flag (flag —55) controls whether the arguments that 
generated the error will be returned to the stack. 


IFERR 
IFERR trap —clause 
trap — clause THEH 


THEM error—clause 
error—clause | ELSE 
EHD normal -—clause 
EMD 





Example: This program (65 bytes, checksum #15A4h) takes the 
a port number p from the stack and returns the port variables. If 
port p is empty, the program returns "". 


eo p 
* IFERR PYARS 
THEN IF -55 FC? THEN DROP END "" 
END 


Error Interpretation. The commands ERRM and ERRN return the 
most recent error message and error number. ERRO clears the 
error number. These commands may be useful in an error clause 
for taking specific action for different kinds of errors. 


User-Defined Errors. The command DOERR accepts either a 
system error number or a string. If the error number is zero, the 
action is equivalent to pressing [ATTN], and ERRM and ERRN are 
set to "" and 0. If a string is supplied, the string will be returned 


by ERRM and the error number will be set to #7 888Gh. 
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Data Entry 

A program may halt to obtain user input using a variety of 
techniques. These techniques have varying levels of restrictions 
on keyboard and stack operations: 


e Execute HALT. The program resumes when the command 
CONT is executed or the user presses [CONT]. The stack is 
available in this state. 


Execute PROMPT. The program displays a message and halts 
until CONT is executed or the user presses [CONT]. This is 
equivalent to the sequence: « ... "String" 1 DISP 3 
FREEZE HALT ... %. The stack is available in this state. 


Execute INPUT, which displays a message and a default 
answer. The program resumes when is pressed. The 
parameters supplied to INPUT provide considerable control 
over the appearance of the display and cursor placement. The 
stack is not available in this state, but menus may be changed. 


Executing WAIT with a 0 or -1 parameter, which returns the 
next keystroke in rc.p format. 


Executing KEY, which returns a key location in rc format, 
otherwise 0 if no key has been pressed. 


Note: Programs that have been HALTed may be completely 
terminated by executing KILL. 


A variety of interface options are available by displaying a custom 
menu before executing the PROMPT, INPUT, or WAIT commands. 


A custom menu provides different utility when used in conjunction 
with the INPUT, PROMPT, or WAIT commands: 
e INPUT: provides typing aids. 


e PROMPT: can provide execution objects which optionally 
include CONT to resume program execution. 


e WAIT: can provide menu key labels for single keystroke 
responses, suchasmenukeys YES or HO . 
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Example: INPUT with Custom Menu. The following program 
fragment (102 bytes, checksum #9067h) accepts a string while 
providing a menu of common answers. The MENU command at 
the end of the program restores the previous menu. 


4 


£ "RED" "ORG" "YEL" "CRN" "BLU" "BHT" 3 
THEHU “Enter = color coder" "" THPUT & MENU 


Example: PROMPT with Custom Menu. The following program 
(241.5 bytes, checksum #A744h) displays a simple menu which 
stores zeros or accumulates numbers into variables A and B. 
When GOHE is pressed the CONT command continues the 
program, which then displays the sums of A and B. 





= 


ote] 


"CLEA" #« & 'A' STO # 
E 1 


¢ "CLEE" « @ ! STO 4 
L nou “ "A! STO+ Se * 
C "B" « 'B' STO+ 
“DONE” ‘CONT o> 
+ THEMU 


"Key values into A & B" PROMPT 
A "A" +TAG B "B" +TAG & MEHMU 
* 


Example: WAIT with Custom Menu. The following program 
fragment (149.5 bytes, checksum #4580h) displays a menu, waits 
fora | -menu key response, beeps on invalid 
ycode of the YES or NO key. 






« £ mve gu i "hye + THEHLI A 
DO DROP -1 WAIT UNTIL 
DUP © 11.1 16.1 3 SWAP POS 
DUP IF HOT THEM 356 .1 BEEP END 
EHD @ MENU 
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Recursion 
Three conditions must be met to permit recursive programming: 


e The system must have an unlimited return stack. 
e The system must have an unlimited data stack. 


e Programs must be able to call themselves. 


The HP 48’s data stack and return stack are limited only by 
available memory, so recursive programming is a technique that 
is available for some forms of problem solving. The programs 
FIB1 and FIB2 in the HP 48 Owner's Manual illustrate that 
recursion may not always be the fastest technique. 


A recursive program uses a technique for repetitive calculation 
that works by breaking a problem into smaller pieces and calling 
itself for each piece. A reference manual for the UNIX operating 
system once defined recursion as follows: 


Recursion: See Recursion 


The definition above is not far off the mark, but it leaves out the 
test condition for completion. 


Factorial Example. The most common illustration of recursive 
programming is the factorial calculation: n!=nx(n-1)x(n- 
2)...2x1, where 1!=1. The test for completion is to see if the input 
parameter n<1. The program FACTRL uses recursion: 


FACTRL 85.5 Bytes Checksum #BAB7h 


2 oF 
* IF m i £ THEW 1 
ELSE mo? = PRCTRE -n- 
EMD 
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Quicksort Example. A quicksort works by breaking a list into 
two smaller lists, then quicksorting each list. The QSORT 
program below keeps all the items being sorted on the stack, 
avoiding the overhead associated with building and decomposing 
list objects. QSORT takes (and returns) the number of stack 
items to sort from level 1. 


The program « OBJ+ GSORT +LIST = provides a “front end" 
to QSORT for list arguments. Large lists should be first stored in 
a global variable to eliminate excessive overhead in temporary 
memory processing (see Temporary Memory). All the items to be 
sorted must have the same type, and must be valid arguments to 
the > command, such as strings or numbers. 


QSORT 216 Bytes Checksum #EEF4h 
Input: n-items nh — 
Output: n-items n —- 


a ¢ 7 
*#nm2-fROLL nm S+en 

START ROT 3 DUPH SWAP ROLLD > - HERT 

4-4 i 

* m ROLLE 1 
IF DUP 1 > 
THEM @S0RT 
EMD 
IF DUP 
THEH 1 SWAP START m ROLLED HERXT i 
EWC 
nm SWAP 1 + - 
IF DUP 1 > 
THEH GS0RT 
EHD DROF nm 
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Meta-— Objects 

The term meta-object refers to a group of objects and their 
count that resides on the stack. Since stack operations are by 
nature very efficient, there are times when decomposing a list 
onto the stack and performing all operations on the stack will be 
more efficient than rebuilding the list between operations. 


The following display shows a meta-object consisting of three 
names and their count: 


= 
a 
= 
m 
by! 


{ 
4 
3 
ra 
1 


KATHRYN 
REE 





The term meta-—stack refers to a group of objects on the stack, 
some of which may be meta-objects. The term position is used 
instead of /evel when discussing meta- stacks, because a meta- 
object actually occupies multiple stack levels. 


The following meta-—stack consists of the string "FRED" in 
position 1, and meta- objects in positions 2 and 3: 


wan u BE Ww iu Cc uw "Tifa" raf Si 5 Tl 3 "PRED! 
Position 3 Position 2 Position 1 
Notation 
To simplify discussions about meta-—objects, the following 
notation is presented. The count is always assumed to be below 
the elements on the stack. 
Stack Notation. The following symbols are used to indicate 


objects and meta-objects on the stack, where the right- most 
element is at the bottom of the stack: 
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ee 2 
< Obj, Obj. Objs > 


<... > Obj 
< Obj... > 
< ... Obj > 


< meta, > < meta, > 


An empty meta-—object on the stack 
(which is just a 0, because the meta-— 
object must have a count). 


An arbitrary meta-— object on the stack. 


A meta-object composed of three 
objects. 


An object in level 1 and a meta-—object 
beginning at level 2. 


A meta -— object on the stack, with Obj at 
the head. The head is the element 
farthest from the count. This is 
equivalent to the decomposition of the 
list { Obj ... }. 


A meta- object on the stack, with Obj at 
the tail. The tail is the element closest to 
the count. This is equivalent to the 
decomposition of the list { ... Obj }. 


Two meta — objects on the meta-— stack. 


Utility Names. Several short utility programs are presented 
below which manipulate meta- objects. The names start with M, 
for Meta-— object, and use the following naming convention: 


Refers to a list. 


| NSNoATDrFEO > 


Refers to the addition of an object to a meta — object. 
Refers to the deletion of an object from a meta -— object. 
Refers to a meta -— object. 


Refers to the head of a meta — object. 
Refers to the tail of a meta — object. 
Refers to an empty meta -— object. 
Refers to the meta -— object in position 2. 


The phrase "to" (converting to another form). 
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Utilities 
To establish an empty meta-—object on the stack, just place a 
zero in level 1. To convert a list or vector into a meta-object, 
execute OBJ—. To convert a meta- object back to a list, execute 
—LIST. To convert a meta—object back to a vector, execute 
—ARRY. 
There are many possible routines for meta— object manipulation. 
The following utility programs are provided to suggest the 
possibilities. Note that there is no error checking! 
MAT adds an object to the tail of a meta-— object: 

<....> Obj - <... Obj > 

MAT 25 Bytes Checksum #3538h 

« SHAP 1 + & 
MAT2 adds an object to the tail of the second meta -— object: 

< meta. > < meta; > Obj — < meta, Obj > < meta, > 

MAT2 53.5 Bytes Checksum #546Eh 

OVER 3 + ROLLE DUP 2 + ROLL 
1 + OVER = + ROLLD 

MAH adds an object to the head of a meta -— object: 

<...> Obj — < Obj... > 

MAH 32.5 Bytes Checksum #4F86h 


* OVER 2 + ROLLE Lf os 
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MAH2 adds an object to the head of the second meta — object: 


< meta, > < meta; > Obj — < Obj meta, > < meta, > 
MAH2 66 Bytes Checksum #1CACh 


& 


OVER BUF 4 + PICK 
2 + ROLL 1 + OVER 


i 


+ + ROLLD 
ROLLD 


DUP 


+ tn 


MZ2 places an empty meta - object in meta-— stack position 2: 
< meta; > — < > < meta, > 
MZ2 27.5 Bytes Checksum #509Bh 


* @ OVER 2 + ROLLD * 


MDT extracts an element from the tail of a meta-— object: 


<...Obj > — <... > Obj 


MDT 25 Bytes Checksum #5F4Dh 


* 1 - SWAP 


MDT2 extracts an element from the tail of the second meta — object: 


< Obj, Obj2 Obj3 ><... > — < Obj, Objp > <... > Objg 
MDT2 56 Bytes Checksum #A95Ch 


“ 


DUP 3 + ROLL OVER 
3 + ROLL 1 -— 3 PICK .3.+ ROLLD 
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MDH extracts an element from the head of a meta — object: 
< Obj... > — <... > Obj 
MDH 32.5 Bytes Checksum #813Dh 
# 1 - DUP 2 + ROLL # 


MDH2 extracts an element from the head of the position 2 
meta — object: 


< Obj, Obj. Obj 2 Sa oat. Ss Objo Obj > a ee Obj, 


MDH2 68.5 Bytes Checksum #BE54h 


+ PICK OVER + 


2 + ROLL OVER 
3 + ROLL 1 - 3 FICE 


+ ROLLE 


ho fal 


ML—M converts lists in levels 1 and 2 into meta-— objects: 
{ list. } { list; } — < meta, > < meta, > 
ML—M 36 Bytes Checksum #BF3H 
€ SWAP OBJ+ BUF 2 + ROLL OBJ+ = 
MM->L converts two meta — objects into lists: 
< meta, > < meta, > — { list.} { list, } 
MM-—L 36 Bytes Checksum #499Ah 


* +LIST OVER 2 + ROLLD +LIST SWAP # 
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MAM2 concatenates two meta -— objects: 
< meta; > < meta, > — < metay,.> 
MAM2 31 Bytes Checksum #FAD4h 
€ DUP 2 + ROLL + ¥ 
MSWAP exchanges two meta — objects: 
< meta; > < meta,> — < meta,> < meta, > 
MSWAP 73.5 Bytes Checksum #C18Fh 
= 


DUF 2 + PICK OVER + 2 +4hn 
* 1 OVER 1 + START nm ROLLD HEXT 2 


Using Meta -— Objects 


Reversing a List. The following program expects a list as input 
and returns the reversed list as output: 


LREV 57.5 Bytes Checksum #D8Cth 


@ SWAP OB.I+ 
DUP 1 SWAP 
START MDT MATZ 
NEXT 

DROP LIST 
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Filtering a List. The following program expects a list as input 
and returns a list of all string objects in the list in their original 
order: 


SFILT 81 Bytes Checksum #26DBh 


@ SWAP OEWJI+ 
DUF 1 SWAP 
START 


MDT IF DUP TYPE 2 SAME 
THEH MAH 
ELSE DROP 
EMD 
HEAT 
DROP +LIST 


Searching a Vector. The following program scans an input 
vector and returns two lists: one with numbers < .5 in level 2, and 
one with the remaining numbers in level 1: 


VSCAN 105.5 Bytes Checksum #3418h 


@ SWAP OBJ+ OBJ+ DROP 


DUP 1 SWAP 

START MDT 
IF BUF .5 > 
THEM MAHS 
ELSE MAH 
EMD 

HET 


+LIST OVER 2 + ROLLD $LIST 
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HP Solve Equation Library 


The HP 82211A HP Solve Equation Library application card 
contains six main applications: 


e The Equation Library application contains over 300 equations 
documented with variable descriptions, units, and pictures. 


e The Periodic Table application contains data for 23 properties 
of 106 elements. 


e The Constants Library contains names and values for a 
collection of physical constants. 


e The Finance application provides the Time-Value-of- 
Money menu from HP financial calculators for compound 
interest and amortization calculations. 


e The Multiple Equation Solver may be used for solving 
problems that contain more than one equation. 


e The Utilities application contains the Minehunt game, several 
new units, and several new functions used by equations in 
the Equation Library. 


The following pages summarize the applications and provide 
reference information. 
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Using Catalogs 
The applications in the HP Solve Equation Library use a common 
environment, called a catalog, for viewing and selecting items. 


For example, consider the name catalog in the Periodic Table 
application: 


Erbium ¢CEr> 


TAELE|NAME | SVE ]ATHT | CENS | UIT | 





The name catalog allows you to choose an element by name. 
The highlight shows the current item. The arrows on the right side 
of the display indicate that additional items are available above 
and/or below the portion of the catalog in the display. 


All catalogs provide the following options: 


(a) [¥) The arrow keys may be used to move the highlight. 
Press [4] and an arrow key to move the highlight 
one screen at a time. Press [>] and an arrow key 
to move to the ends of the catalog. 


(a) Press [a] and a letter to move to the next item 
starting with that letter. 





Menu keys provide various application—specific 
options. 


ENTER Selects the highlighted item. If the item ends with 
..., displays the complete item. Press [ATTN] or 
ENTER] to return to the catalog. 


Exits the application. 
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Equation Library 

The Equation Library application contains 102 equation titles 
divided into 15 subject areas. The Equation Library may be used 
interactively or an equation set may be accessed for use by the 
solver with the SOLVEQN command. 


Interactive Equation Library 

The following example illustrates the use of the interactive library. 
Suppose a projectile is launched at an angle of 35° with an initial 
velocity of 150 m/s. What is the range of the projectile? 


Execute EQNLIB to display the subject catalog: 


. els N 
Columns and Be 


Forces and Energy 
Gases 

Heat Transfer J 
BO EC a ee 





When the subject catalog is displayed, you can do the following: 
e Select SI or English units by pressing SI or EHS . 
e Choose to use or not units by pressing UHIT . 
e Press to display the title catalog for the highlighted 
subject. 


If neccessary, press SI and UHIT to place boxes in their 
menu keys. 
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Press [a] (M) [¥] to highlight the MOTION subject, then to 
display the title catalog: 


Angular Motion 
Circular Motion 
Terminal Velocity 1 
EC ed a Ed 





The following options are available when you are viewing an 
equation set: 


Places the current equation set in the solver. 


View the current equation(s) in EquationWriter 
format. 





Display the variables for the equation set. 


Display the picture associated with the equation set. 





Place the equation set on the stack. 
ENTER View the current equation(s) in algebraic format. 


Return to the subject catalog. 






It to display the picture for the Projectile 


VK 


——— x 
SOLY 





While you are viewing the picture, +F ICT may be used to place 
a copy of the picture in P/CT. 
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Press ‘HFS to display the variable catalog: 


x5 “nit dealer 


y@2 init y-position 


ae final y- Posen 
@: initial aA pete 

Vi initial velocity J} 

ET ee ee ES 





Press to display the units for each variable: 





1 
BE ES OT Ed es 


When this page of the variable catalog menu is displayed, the 
following options are available: 


Selects SI units. 
Selects English units. 
Selects units or no— units option. 





Forces the equation set’s variables to have the 
current units. 


Purges the equation set’s variables. 







Returns to the title catalog. 
Returns to the first page of the variable menu. 


to display the first of the five equations in 
isplays the next equation in the set): 





ELT CE Ros Be Ea 
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Press 
solver: 





to place the equation set in the multiple equation 


Projectile Motion 





Notice that the units for the angle are automatically appended to 
the number you entered. Press [NXT] to view the next page of 


variables, and enter the initial velocity by pressing 150 5 ‘4 


R?_ 2155. 99455142_m 


Emcee CT Cae 





See Multiple Equation Solver for a more detailed discussion of the 
Multiple Equation Solver. 
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Programmatic Equation Library 

The command SOLVEQN may be used to place a set of 
equations from the Equation Library into the built-in solver for 
single equations or the Multiple Equation Solver for multiple 
equation sets. The level 3 and 2 parameters specify the subject 
and title number. If the level 1 parameter is nonzero, the picture 
associated with the equation set will be placed in P/CT. 


SOLVEQN Command 


Places Equation Library equation(s) in solver. 
subject title PIlCT-option — 





The following table shows the subject and title numbers that may be 
used with the SOLVEQN command. If the TYPE is listed as S, the title 
contains a single equation; M indicates a set of multiple equations. A 
Y listed under PICTURE indicates that a picture is associated with the 
title. 


COLUMNS AND BEAMS 


TITLE# TITLE TYPE 


Elastic Buckling 
Eccentric Columns 
Simple Deflection 
Simple Slope 

Simple Moment 
Simple Shear 
Cantilever Deflection 
Cantilever Slope 
Cantilever Moment 
Cantilever Shear 


PICTURE 


poonownonsl 
cosssseedl 


aa 
1 
2 
3 
4 
5 
6 
7 
8 
9 
10 
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ne 


Coulomb’s Law 
Ohm’s Law and Power 
Voltage Divider 
Current Divider 

Wire Resistance 
Series and Parallel R 
Series and Parallel C 
Series and Parallel L 
Capacitive Energy 
Inductive Energy 

RLC Current Delay 

DC Capacitor Current 
Capacitor Charge 

DC Inductor Voltage 
RC Transient 

RL Transient 

Resonant Frequency 
Plate Capacitor 
Cylindrical Capacitor 
Solenoid Inductance 
Toroid Inductance 
Sinusoidal Voltage 
Sinusoidal Current 





























OANOD AARWND — 





FITIANHVNHNZEHVHDSVHNDESESERNAVHNSSZSSERAVNEN 








FLUIDS 








Pressure at Depth 
Bernoulli Equation 
Flow with Losses 
Flow in Full Pipes 
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| 4 FORCES AND ENERGY 
TITLE# TITLE TYPE 
1 


Linear Mechanics 
Angular Mechanics 
Centripetal Force 
Hooke’s Law 


PICTURE 


1D Elastic Collisions 
Drag Force 

Law of Gravitation 
Mass -— Energy Relation 


vooseeeeld 


<i 





Ideal Gas Law 

Ideal Gas State Chg 
Isothermal Expansion 
Polytropic Processes 
Isentropic Flow 

Real Gas Law 

Real Gas State Change 
Kinetic Theory 





SnOssseene 
es 


HEAT TRANSFER 
Heat Capacity 















Thermal Expansion ¥ 
Conduction Y 
Convection Y 
Conduction + Convection Y 
Black Body Radiation Y 
MAGNETISM 
Straight Wire S 4 
Force Between Wires Ss Y 
B Field in Solenoid S Y 
B Field in Toroid S ¥. 
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ae MOTION 
TITLE# TITLE PICTURE 








1 Linear Motion 
2 Object in Free Fall 
3 Projectile Motion Y 
4 Angular Motion 
5 Circular Motion 
6 Terminal Velocity 
7 Escape Velocity 

Oe 
1 Law of Refraction S Y 
2 Critical Angle S Y 
3 Brewster's Law M Y 
4 Spherical Reflection M Y 
5 Spherical Refraction S Y 
6 Thin Lens M 4 





| 100 OSCILLATIONS 


Mass - Spring System Y 
Simple Pendulum x: 
Conical Pendulum y. 
Torsional Pendulum ¥ 
Simple Harmonic 


| ad PLANE GEOMETRY 


Circle 
Ellipse 
Rectangle 
Regular Polygon 
Circular Ring 
Triangle 


ahwWDND = 
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| 12 | SOLID GEOMETRY 
oe TITLE a 


Cone 

Cylinder 
Parallelepiped ¥: 
Sphere Bd 


SOLID STATE DEVICES 


PN Step Junctions 
NMOS Transistors 
Bipolar Transistors 


JFETs 


Normal Stress 

Shear Stress 

Stress on an Element 
Mohr’s Circle 


Transverse Waves 
Longitudinal Waves 
Sound Waves 
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Periodic Table 
The Periodic Table application contains data for 23 properties of 106 


elements. This data may be used in programs to calculate molecular 
weights of chemical formulas or to display various properties of the 
elements. 


Interactive Periodic Table 
Execute PERTBL to start the interactive periodic table: 


DENSITY: 
0.0899 


DES Chas Es 





When the table is displayed, you can do the following: 
e Press the arrow keys to move around the table. 


e Use the HAME or SME catalogs to locate an element. 
Use the arrow keys to move the highlight to the desired 
element, then press THELE to return to the table or 
to view the property catalog. 


e Press to display the property catalog. 


e Press ATHT or [GEHS to put the atomic weight or density 
on the stack. 


e Press [a] to calculate molecular weights. 


e Press (LIT to end the application. 
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Example: To examine the properties of aluminum, press 
ENTER}: 


ass Nos 
At Witt 26,98154_9/am. 


Density: 2.76_9/cm 

Ox States: 3 

Elec Cfg: [CNe]3s2-3pli] 
Cd a OT es es 





Move the highlight to explore the properties of aluminum. Press 
to return a property to the stack. 





It might be interesting to note the density of aluminum compared to 
other elements. One way to do this is to plot densities versus atomic 
number. Move the highlight to Density and press : 











Move the cursor at the bottom of the graph by pressing the arrow 


keys. Press to return to the property catalog, or to 
select a new element. 





You can return to the periodic table display by pressing 
you'll be positioned at aluminum: 


,and 





DENSITY: 
2.70 


THELE]NAME | SME] ATHT 
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Calculating Molecular Weights 

In the interactive periodic table, press [a], enter the formula, and 
press [ENTER]. When a formula is being entered, press [) [C)] to 
enter <, or press [p>] [#] to enter >. When the result has been 
displayed, press to return the answer to the stack or to 
return to the table. 


The MOLWT command may be used in algebraic expressions or 
programs to calculate the molecular weight of a formula: 


MOLWT Function 
Calculates molecular weights 
‘element-name’ —+ atomic-—weight 


‘formula’ — molwt 
"formula" — molwt 
"MOLWT (formula)’ 





The string parameter is valid for any formula. If a name parameter 
represents a valid formula, the molecular weight of that formula will be 
returned. If a name parameter is not a valid formula, the variable 
represented by that name will be searched for a formula. 


The following table contains examples of valid molecular formulas. 
The results assume the formula for benzene ( "C6H6" ) is stored in the 
variable Benzene. 


He He 4.0026_g/gmol 
Hz SO, H2S04 98.0734 _g/gmol 


Mg(ORH)>. Mg(Oh)2 58.3196 g/gmol 
(CH3)2S (CH3)2S 62.1294 g/gmol 
Benzene Benzene 78.1134 g/gmol 
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Extracting Element Data 

The PTPROP command may be used in algebraic expressions or 
programs to return data from the periodic table database. Properties 
returned as unit objects return real objects if flag 61 is set (no units). 
Unknown values return the string "—". 


PTPROP Function 
Returns data from Periodic Table database 
atomic-number property-number -—> data 
‘element-—symbol’ property-number —> data 
*PTPROP (element -symbol,property —-number)’ 


[Propery [Type [Number 
Atomic Number 
Mass Number 
Atomic Weight 
Density 
Oxidation States 
Electronic Configuration 
State 
Melting Point 
Boiling Point 
Heat of Vaporization 
Heat of Fusion 
Specific Heat 
Group (U.S. Customary) 
Family 
Crystal Structure 
Atomic Volume 
Atomic Radius 
Covalent Radius 
Thermal Conductivity 
Electrical Conductivity 
First lonization Potential 
Electronegativity (Pauling’s) 
Oxide Behavior 
Element Name 
Element Symbol 


OOAONDOORWNDN — 
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Constants Library 

The Constants Library contains a collection of names and values of 
physical constants which may be selected from an interactive catalog 
or returned using the function CONST. 


Constants Catalog 

The constants catalog shows the descriptions and values of the 
constants. Suppose you want to place the SI value of Boltzmann’s 
constant on the stack. Execute CONLIB to display the catalog: 


=: molar volume 


universal gas 
StdT: std temperature 
StdP: std pressure 
Pst eT ENGLIUNIT @|VALUE] STK | QUIT | 





The softkeys SI , EHGL ,and UHIT control the type and 
usage of units. The value returned will respect the SI/English 
selection regardless of whether units are used. 


Press [¥] to highlight Boltzmann’s constant, then 'ALUE to display 
the values instead of the names: 


H “universal gas 

StdT: std temperature 
tdP: std pressure 

Pst ePENSL UNIT a VALUE] SSTK| QUIT | 





Press +5TK_ to place the value on the stack, then GLIIT to exit 
the application. 


= 
a 
= 
m 
yt 


Moki 


k? 1.388633E-23_J“kK 
TS a 
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CONST Command 
The CONST command may be used in algebraic expressions or 
programs to return a constant from the Constants Library. 


CONST Function 


Returns the value of the specified constant 
name — __ value 





The units of the value returned are affected by flags 60 (SI if clear, 
English if set) and 61 (units if clear, no units if set). Note that the value 
returned respects flag 60 regardless of the state of flag 61. 


Example: An equation for free — fall velocity: 
'VEVG-CONST(g)#T! 


wae 


COHST¢g > returns the acceleration due to gravity using units as 
specified by flags 60 and 61. 


In a program that performs the same operation, CONST takes the 
constant’s name from the stack: 


« Vao'g' CONST T # - ¥ STO 
Note: Program variables may have the same names as constants if 
you include ' marks around the constant names so that CONST 
finds the constant name instead of a variable value. 
The table on the following two pages lists the available constants in 


the Constants Library. Note that one name uses an accented 
character: ¢. To type this character, press [a] O (a) (->)(9]. 
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ane [ssi 


Avogadro’s number 
Boltzmann constant 

Molar volume 

Universal gas constant 
Standard temperature 
Standard pressure 

Stefan-— Boltzmann constant 
Speed of light in vacuum 
Permittivity of vacuum 
Permeability of vacuum 
Acceleration due to gravity 
Gravitational constant 
Planck’s constant 

Dirac’s constant 

Electronic charge 

Electron rest mass 

q/me ratio (electron charge—-to— mass) 
Proton rest mass 

mp/me ratio (proton, electron mass) 
Fine structure constant 
Magnetic flux quantum 
Faraday constant 

Rydberg constant 

Bohr radius 

Bohr magneton 

Nuclear magneton 
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same [Destin 


Photon wavelength 
Photon frequency 
Compton wavelength 
1 radian 


2n radians 
180° angle (in current trig mode if no units) 


Wien’s displacement law constant 
k/q (Boltzmann, electronic charge) 
€0/q (permittivity, electronic charge) 
q ‘0 (electronic charge, permittivity) 
Dielectric constant of silicon 
Dielectric constant of silicon dioxide 
Reference intensity 
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Finance 

The Finance application may be used for compound interest 
calculations where identical payments occur over regular periods 
which coincide with the compounding periods. In Time-—Value—of- 
Money (TVM) calculations money received is displayed as a positive 
number; money paid out is displayed as a negative number. 


Cash Flow Diagrams 

TVM cash flow diagrams show money received as an arrow pointing 
up, and money paid out as an arrow pointing down. The following 
diagrams illustrate cash flows from the borrower's and lender’s point 
of view: 





PMT PMT PMT PMT PMT PMT 
Loan From Borrower’s Point of View 


PMT PMT PMT PMT PMT PMT 





Loan From Lender’s Point of View 
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TVM Calculations 

The TVM menu entries store or calculate the following: 
RCT] Number of periods N 

2 : Annual interest I%YR as a percentage 

' PY; Present value 

7 : Payment amount 

: Future value 

_ Calculates amortization 

| t 

: Stores the number of payments per year 

Sets Begin mode: payments at each period’s start 

Sets End mode: payments at each period’s end 












To begin a new TVM problem, set the number of payments per year 
and Begin or End mode as needed. To change the number of 
payments per year, key in the iyits ale and press P-‘ 








To solve TVM problems, enter the values you know and solve for the 
unknown by pressing [#] followed by the appropriate key. 


Example: The new 1990 Grande Chrome Deluxe sells for $26,780. 
The buyer has $8500 for a down payment. Calculate the payments 
on a four-year loan with 13% annual interest, starting at the 








(4) - - menu in FIX 2 display mode: 
Display: 
12 payments“year 
EMD mode 
H: 45,688 
InvR: 135.68 
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Amortization 

An amortization schedule may be calculated after a loan is specified 
in the WM | menu by entering the number of periods to amortize and 
pressing | 





AMORT Command 


Calculates amortization from TVM variables 
payments — principal interest balance 





To continue an amortization, store the balance back into PV and 
execute AMORT for the next number of periods desired. 


Amortization Example: A four-year home equity loan of $15,000 
has an 11% annual interest rate. Starting in the TVM menu in FIX 2 
display mode, calculate the payment, then the interest and principal 
payment contributions for the first two years: 


Keys: Display: 

12 payments“year 

EMD mode 

Hs 45.88 
VF 





32 Principal=—-3155.24 
2: Interest=-1493. 92 
1 Balance=11541. 


oo PY i112. AMRT St Principal=-s3523.71 
2: Interest=-1125.45 
1: Balance=85315.85 
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TVMROOT Command 
The TVMROOT command may be used in a program to perform TVM 
calculations. 


TVMROOT Function 


Solve for TVM variable using the other TVM variables 
‘TVM-variable’ — value 





The procedure for programmatic calculations is similar to the 
keyboard procedure: 


e Set the payment mode to begin or end mode using TVMBEG 
or TVMEND. 


e Store the known values in the TVM variables. 

e Execute TVMROOT for the unknown variable. 
Example: This program returns the amount of money that can be 
borrowed and the total interest that would be paid given the annual 
interest rate in level 3, the number of years in level 2, and desired 


payment in level 1. Remember to supply a negative number for the 
payment. 


AMT 163.5 Bytes Checksum #4B4h 


TYMEMD Sets the payment mode 

i ssl 8 a 82 Stores the payment 

12 * 'H' STO Stores the number of payments 
tT) < STO Stores the annual interest rate 
12 'PYR' STO Stores the payments per year 

@ 'FY' STO The loan will be paid off 

‘PY TYMEOOT Solves for the loan amount 

DUP 'PY' STO Stores the present value 

H AMORT Amortizes the loan 

ROT DROPS Drops the balance and principal 
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Multiple Equation Solver 
The Multiple Equation Solver application may be used for solving 
problems that contain more than one equation. 
To use the Multiple Equation Solver, perform the following steps: 
e Define the list of equations and store them in EQ. 
e Execute the MINIT command to establish Mpar. 


e Execute the MSOLVR command to display the Multiple 
Equation Solver menu. 


e Enter the values for the known variables. 


e Solve for any variable or all unknown variables based on the 
known values: 


e Solve for a single variable by pressing [4] followed by 
the appropriate key, or 


e Solve for all the variables by pressing (4) ALL . 


e Review the values for all variables in the menu by pressing 


(4) (REVIEW). 
e Review the progress catalog by pressing [>] ALL . 


The Multiple Equation Solver menu labels indicate the status of each 
variable: 


Key Interpretation 


X unknown 

X unknown, found in the last solution 
X known, unused in last solution 

X known, used in last solution 
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Example: Store the equations for the length and volume of a cone 
(f{ 'LEPCR*S+H*23' 'Y=en*R°2*H-3' + ) in the variable EQ, 
execute MINIT, then MSOLVR. Find the surface area and volume of a 
right circular cone having a radius of 8 and a height of 24. 








Keys: Display: 

sf RO oan 

24 H: 24 

(4): 

[4] Li 25.2982212515 
Vi 1665, 49543563 
Ri 3 
Hi 24 


Programming. The Multiple Equation Solver may be used in 
programs. The commands MCALC and MUSER may be used to set 
the unknown and known states of a variable. The command MROOT 
solves for either a single variable or all unknown variables. 


MCALC Command 
Sets Multiple Equation Solver variable to not user-defined 
‘name’ — 
{ name, ...name,} — 
"ALL" — 
MROOT Command 


Solves for single or all variables using the Multiple Equation Solver 


‘name’ — value 
"ALL" > 


MUSER Command 
Sets Multiple Equation Solver variable to user-defined state 
‘name’ — 
{ name, ... name, } — 
"ALL"  — 
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Utilities 

The Utilities application consists of a game, eight commands, and 
four new units. The commands and units are described in the next 
section, Command Reference. 


Minehunt 

The Minehunt game challenges you to navigate a battlefield littered 
with buried mines. Your mine detector was a low—bid item, and 
consequently is only able to tell you how many mines are adjacent to 
your square. You may be beside up to seven mines! 


45> NEAR 1 MINE SCORE: 1 





The number keys (2], (8), [4], [6], and arrow keys [¥], [4], (<), B®] 
move you from square to square. The number keys [1], [3], [7], and 
(9) permit diagonal movements. 


The game ends when you reach the lower—right corner or step on a 
mine. To interrupt a game when you need to use the HP 48 for other 
tasks, press [STO]. The state of the game will be stored in MHpar 
until MINEHUNT is executed again. 


The score in the upper-right corner tracks the number of squares 
you have occupied. You may play to either maximize or minimize the 
number of squares occupied. 


The default number of mines is 20. To change this value, store the 


desired number of mines in the variable Nmines. A negative value 
will show the buried mines. 
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Command Reference 

This command reference lists the stack diagrams for all commands 
and functions in the HP 82211A HP Solve Equation Library 
Application Card. Each entry lists the name, description, and stack 
diagrams if applicable. 


NAME 


Description 


Input Output 
Level, Level, Level, -—> Level, Level, Level, 


AMORT Command 
Calculates amortization from TVM variables 
payments — principal interest balance 


CONLIB Command 
Starts the Constants Library 


CONST Function 
Returns the value of the specified constant 
‘constname’ — constant 


DARCY Function 
Calculates Darcy friction factor 


e/D Re d 

*symb’ x ‘DARCY (symb,x)’ 

x ‘symb’ "DARCY (x,symb)’ 
*symb,’ ‘symb,’ ‘DARCY (symb,,symb,)’ 


dB Unit 
Dimensionless unit for decibel 


ELVERSION Command 
Displays the HP 82211A version message 


EQNLIB Command 
Starts the Equation Library 
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FOX Unit 


Calculates fraction of black —body emissive power at temperature T 
between wavelengths 0 and A 


A T- fraction 


FANNING Function 


Calculates Fanning friction factor 
e/D Re f 
*symb’ x *FANNING(symb,x)’ 
x ‘symb’ *FANNING(x,symb)’ 
"symb,’ ‘symb,’ ’FANNING(symb,,symb,)’ 
gmol Unit 
Unit for gram—mole 


Ibmol Unit 
Unit for pound —- mole 


MINEHUNT Command 


Starts the Minehunt game 


MINIT Command 
Establishes Mpar from EQ 


MITM Command 
Changes title and variable menu in Mpar 
"title" { name, ... name, } = 


MCALC Command 
Sets Multiple Equation Solver variable to not user-defined state 
‘name’ — 
{ name, ...name,} — 
"ALL" — 


MOLWT Function 
Calculates molecular weights 
‘element-name’ —  atomic-weight 
‘formula’ — molwt 


"formula" — molwt 
*MOLWT (formula)’ 
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MROOT Command 
Solves for single or all variables using the Multiple Equation Solver 
‘name’ — __ value 
"ALL" — 
MUSER Command 
Sets Multiple Equation Solver variable to user-defined state 
‘name’ — 
{ name, ...name,} — 
"ALL" — 


MSOLVR Command 


Displays the Multiple Equation Solver menu 


PERTBL Command 
Starts the Periodic Table 


PTPROP Function 


Returns data from Periodic Table database 


atomic-number property-number —> data 
‘element-symbol’ property-number — data 
’PTPROP (element -symbol,property —-number)’ 


rpm 
Unit for revolutions per minute 


SIDENS Function 
Intrinsic density of silicon as a function of temperature 
T — — density 
‘symb’ —+ ’'SIDENS(symb)’ 
SOLVEQN Command 
Places Equation Library equation(s) in solver 
subject-number title-number PICT-option — 


TDELTA Function 
Calculates temperature increment 
T; To increment 
‘symb’ x *TDELTA(symb,x)’ 
x ‘symb’ "TDELTA(x,symb)’ 
*symb,’ ‘symb,’ "TDELTA(symb,,symb,)’ 

Note: 
Values returned by TDELTA have level 2 units. 
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TINC Function 
Adds temperature increment 

T, increment To 

x ‘*symb’ 

"symb,’ ‘symb,’ 


"TINC(x,symb)’ 


— 
*symb’ x — ~~ ‘TINC(symb,x)’ 
—_— 
—  'TINC(symb,,symb,)’ 


Note: 
Values returned by TINC have level 2 units. 


TVM Command 
Displays the TVM menu 


TVMBEG Command 
Sets TVM Begin mode 


TVMEND Command 
Sets TVM End mode 


TVMROOT Function 
Solve for TVM variable using the other TVM variables 
"TVM-variable’ —+ value 


ZFACTOR Function 


Calculates gas compressibility factor Z 


Tr Pr ~~ 2 
‘symb’ x —+ ‘ZFACTOR(symb,x)’ 
x ‘symb’ — 'ZFACTOR(x,symb)’ 
’symb,’ ’symb,’ —+ ’‘ZFACTOR(symb,,symb,)’ 





HP Solve Equation Library 93 


Reserved Variables 
The applications use reserved variables to store equations and/or 
state information. These variables may reside in any directory. 


[Nano [espion 


Saves state of Minehunt game 


Saves multiple equation solver set 
Specifies number of Minehunt mines 
Saves last position in Periodic Table 





Flags 
The applications use three user flags to control the values and units 
used in calculations: 


SI units English units SI units 


Units used Units not used Units used 
End mode Begin mode End mode 
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Messages 


Hex _| Dec _ Multiple Equation Solver Messages 


Invalid Mpar 
Single Equation 
EQ Invalid for MINIT 
Too Many Unknowns 
All Variables Known 
Illegal During MROOT 
Finance Messages 
No Solution 
Many or No Solutions 
I%YR/PYR < - 100 
Invalid N 
Invalid PYR 
Invalid #Periods 
Undefined TVM Variable 
Constants Library Messages 
10F01 69377 Undefined Constant 
Periodic Table Messages 


11001 69633 Bad Molecular Formula 
11002 69634 Undefined Element 
11003 69635 Undefined Property 


Library Identifiers 





Equation Library 
Periodic Table 
Constants Library 


Finance Library 

Multiple Equation Solver 
Utilities 

Equation Reference 
Catalog Utility 
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System Operations 


To invoke a system operation, press and hold [ON], then press 
and release the second key, then release [ON]. 


[A] and [F] Erases all memory (including port 0 and merged 
memory) and sets the HP 48 to its default states 
(merged memory remains merged). 


Cancels the current selection if selected before 
all keys are released. 


Brings the calculator back into a known state 
without resetting user memory. The stack is 
cleared, the VAR directory is set to HOME, the 
MTH menu is displayed, User mode is cleared, 
PICT is cleared, and the system configuration is 
updated to recognize all libraries. 


[D) Starts the interactive self test (see below). 
(E) Runs a continuous self test. 
Coma mode: a deep-sleep shutdown which 


turns off the the system timers (including the 
clock) and clears the system halt log. 


Performs a_ graphics screen dump _ in 
HP 82240A/B graphics format (regardless of 
1/O port selection). 


or(-] Adjusts the display contrast. 


TIME Cancels the next repeating alarm. 
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System Halt Log 

The command WSLOG returns four strings to the stack showing 
the cause, date, and time of the four most recent system halt 
events. 


The system halt log is not cleared when memory is erased, and 
may only be cleared by placing the calculator in coma mode. 


Example: 3-63-6698 89:36:18 


This string shows a type three system halt that occurred on the 
morning of March 6, 1990. 


Coma exit 

Low battery system save 
|/O timeout 

Execute through address 0 
Corrupt time 

Port change data 
Hardware difficulty 
Hardware difficulty 
Corrupt alarm list 
Corrupt memory 
Module pulled 

Hardware reset 
Software difficulty 
Corrupt configuration 
System RAM card pulled 


0 
1 

2 
3 
4 
5 
7 
8 
9 
A 
B 
C 
D 
E 
F 





Note that some events will cause two events to be recorded, and 
some system halt events will cause a coldstart. 
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Interactive Self Test 
The [D) sequence enters the HP 48 interactive self test. Once 
the test has been started, there are a variety of options: 


Ne PR RREReER0OE280R852°ROR0090002 
5 


0g 


Displays the CPU speed 

Press for display test patterns 
Internal ROM check 

Internal RAM check 

Keyboard test 

Partial keyboard test 

ESD test monitor. Bars indicate battery status. 
UART loop back test 

Wired UART echo 

Shows what’s plugged in 

Test port RAM devices 

Blank display 

Send system time from IR port 
Receive system time from IR port 
Wireless loop back 

Wireless UART echo 

Show test start time 

Show test fail time 

Looping test 

Looping test 

Looping test 

Looping test 

Initialize test times 

Looping test 

Looping test 

Test summary 

Enters Memory Scanner 


Press to return to the stack display. 


System Operations 


Memory Scanner 
The Memory Scanner provides an eight byte window into 
memory. To start the Memory Scanner, start the interactive self 
test ((ON] [D]), then press [—). When finished, press to 
return to the stack display. 





The current address is shown on the left, followed by eight bytes 
of memory. This address, if executed, shows the revision and 
copyright message (press to execute at the displayed 
address): 


Yersion HP4 
Copyright HP Sogo 





Warning: Pressing at any other address than the first 
address displayed by the Memory Scanner can very likely corrupt 
memory and produce the following display: 


Memory Clear 





Gta Go itt Eo se ee 
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Once the Memory Scanner has been started, there are a variety of 
options: 


(fo) - (9) Hexdigit poke 

[A] - (F) Hexdigit poke 

(-] Change address by #0001h 

(x) (=] Change address by #0100h 

(Vv) (4) Change address by #1000h 
Hardware control address 

[x] Display RAM address 

System Halt Log address 

(Z) Port 1 address 

DEL Port 2 address 

Execute starting at this address 
(J Print current data 

SPC Serial memory dump 32K 9600 baud 
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Printer Control 


The following system flags (default clear) control output to the 
printer as follows: 


IR printer Serial printer 


Single spaced | Double spaced 
Linefeeds No linefeeds 





The following control codes guide the operation of the HP 82240B 
printer: 


Printer Command Control Codes* 


Carriage right 

Carriage return/LF 
Column graphics 

Roman 8 character set ¢ 
ISO 8859-1 character set 


Underline off t 
Underline on 
Single wide print + 
Double wide print 
Self—test 

Reset 


*Decimal value t 1<n <166 ¢ Default mode 





Codes 248 and 249 were not included in the original HP 82240A 
printer. Characters 148 and 160 were blank on early versions of 
the HP 82240A printer. The HP 48 character set can be 
remapped to match the HP 82240A printer with the OLDPRT 
command. 
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This example (142.5 bytes, checksum #1380h) prints a simple 
graphics pattern on the HP 82240. 


Dot Value Example 


255 197 171 149 169 213 163 255 





27 8 8 byte graphics command 
ean 197 171 145 Graphics data 
169 213 1635 255 
"" 1 18 START Loop start 
SWAP CHR SWAP + Accumulate data 
HEXT FRI = Loop end, print graphics 
PRTPAR 


The reserved variable PRTPAR may only reside in the HOME 
directory. Other variables of the same name in subdirectories will 
be ignored by the PRINT commands. 


PRTPAR — 


{ delay "remap" linelen "“lineterm" } 


delay Time required to print line: 0 << t <6.9 seconds 
"remap" Character set remapping string 

linelen Serial print line length 

“lineterm" Serial print line terminating characters 
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Built—In Units 


UNIT PREFIXES 


[HP 4a Symbol_| Prefix | Number | Name | 


quintillion 
quadrillion 
trillion 
billion 
million 
thousand 
hundred 
ten 

tenth 
hundredth 
thousandth 
millionth 
billionth 
trillionth 
quadrillionth 
quintillionth 


um 


T 
G 
M 
k, 


= 
IA 





oP -“p st 50 20 


Improper prefix—unit combinations that match built-in units are: 
au, cd, ct, cu, ft, flam, keh, meh, min, mmi, Fa, eh, 
and pt. 


DIMENSIONLESS UNITS OF ANGLE 


Arcmin arcmin 1/21600 unit circle 
Arcsec 1/1296000 unit circle 


Degree 1/360 unit circle 
Grad ara 1/400 unit circle 
Radian 1 /2z unit circle 

Steradian = 1/4 unit sphere 
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Unit 


> > 


acre 
arcmin 
arcs 


atm 


104 


Name 


Are 

Ampere 
Angstrom 
Acre 

Minute of arc 
Second of arc 


Atmosphere 


Astronomical unit 
Barn 


Bar 
Barrel 
Becquerel 


Int’l Table Btu 


Bushel 
Speed of light 


Coulomb 
Degree Celsius 


Calorie 


Candela 
Chain 
Curie 
Centimeter 


Square centimeter 
Cubic centimeter 


Centimeter per second 


Carat 


Type 

area 

electric current 
length 

area 

plane angle 
plane angle 


pressure 


length 
area 


pressure 
volume 
activity 
energy 
volume 
speed 


electric charge 
temperature 


energy 


luminous intensity 
length 

activity 

length 


area 
volume 


speed 


mass 


Value 


100 m? 

1A 

1x10-'m 
4046.87260987 m? 
4.62962962963x 10-5 
.71604938272x10~7 


101325 “Q_ 
m:s@ 


1.495979x10''! m 
1x10~28 m2 
100000 +a - 

ms 
158987294928 m? 
1 


s 


1055.05585262 kgm 


Ss 
03523907 m? 


299792458 > 
1A‘s 


4.1863 Kame 

s2 
1cd 
20.1168402337 m 


3.7x101° 
s 


01m 
0001 m? 
.000001 m? 


ore 
Ss 


.0002 kg 


Built-In Units 


Unit Name 


cu U.S. cup 

d Day 

dyn Dyne 

erg Erg 

eV Electron volt 

F Farad 

°F Degree Fahrenheit 
fath Fathom 

fbm Board foot 

fc Footcandle 

Fdy Faraday 

fermi Fermi 

flam Footlambert 

ft Int'l foot 

ft*2 Square foot 
ft°3 Cubic foot 

ftUS U.S. survey foot 
ft/s Feet/second 
ft*lbf Foot - pound — force 
g Gram 

ga Standard freefall 
gal U.S. gallon 
galC Canadian gallon 
galUK U.K. gallon 
Built-In Units 





Type 
volume 
time 


force 
energy 
energy 


capacitance 


temperature 
length 
volume 


illuminance 
electric charge 
length 
luminance 
length 

area 


volume 
length 


speed 
energy 
mass 
acceleration 


volume 
volume 


volume 


1.60219x10- 12 kame 


s 
A2-s4 
kg:m2 





1.82880365761 m 


002359737216 m? 


cd 
.856564774909 — 
m? 


96487 A:s 
1x10-'5m 
cd 


3.42625909964 — 
me 


.3048 m 
.09290304 m? 
.028316846592 m? 
.304800609601 m 


3048 7 
s 


1.35581794833 kgf 


s 
.001 kg 


9.80665 
s? 
003785411784 m? 


.00454609 m? 
.004546092 m? 
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Unit 
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Name 
Gram-—force 


Grade 
Grain 


Gray 
Hour 
Henry 
Hectare 


Horsepower 


Hertz 


Inch 
Square inch 
Cubic inch 


Inch of mercury 
Inch of water 


Joule 

Kelvin 

Kilocalorie 
Kilogram 
Kilopound — force 


Kilometer 
Square kilometer 


Nautical mile per hour 


Kilometer per hour 


Type 
force 


plane angle 
mass 


absorbed dose 
time 
inductance 
area 


power 


frequency 


length 
area 
volume 


pressure 
pressure 


energy 
temperature 
energy 


mass 


force 


length 
area 


speed 


speed 


.0025 


745.69987 1582 kg-mrf 


s 
1 


Ss 

0254 m 
.00064516 m? 
.000016387064 m* 


3386.38815789 a. 
ms 


248,84 —K9_ 
m:s2 
, kg? 
s2 
1K 


4186 kg 
s 


1kg 
4448,22161526 «om 
s 


1km 
1 km? 


514444444444 “ 


277777777778 > 


Built-In Units 


Unit Name Type Value 





I Liter volume .001 m? 
lam Lambert luminance 3183.09886184 a 
Ib Avoirdupois pound mass .45359237 kg 
Ibf Pound — force force 4.44822161526 «om 
s 
Ibt Troy pound mass .3732417 kg 
Im Lumen luminous flux 7.957747 15459x10-2 cd 
Ix Lux illuminance 7.95774715459x10-2£4 
lyr Light year length 9.46052840488x10'® m 
m Meter length 1m 
m*2 Square meter area 1m? 
m*3 Cubic meter volume 1m? 
pb Micron length .000001 m 
MeV Mega electron volt energy 1 60219x10-9- Kame 
s' 
A2-s3 
mho Mho electric conductance 1 
kg:m? 
mi Int'l mile length 1609.344 m 
mi*2 Int'l square mile area 2589988. 11034 m? 
mil Mil length .0000254 m 
min Minute time 60s 
miUS U.S. statute mile length 1609.34721869 m 
miUS*2 U.S. statute sq. mile area 258998.47032 m? 
mm Millimeter length .001 m 
mmHg _ Millimeter of mercury pressure 133.322368421 *o_ 
m:s 
ml Milliliter volume .000001 m? 
mol Mole amount of substance 1 mol 
Mpc Megaparsec length 3.085678 18585x 1072 m 
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rd 


rem 
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Name 


Mile per hour 


Meter per second 


Newton 


Nautical mile 
Ounce 

U.S. fluid ounce 
Troy ounce 

U.K. fluid ounce 


Poise 
Pascal 
Parsec 
Poundal 
Phot 


Peck 


Pound per sq. in. 


Pint 
Quart 
Radian 


Roentgen 
Degree Rankine 
Rad 

Rod 

Rem 

Second 


Siemens 


Type 
speed 
speed 
force 


length 
mass 
volume 
mass 
volume 


dynamic viscosity 
pressure 


length 


force 


illuminance 
volume 
pressure 


volume 
volume 
plane angle 


radiation exposure 
temperature 
absorbed dose 
length 

dose equivalent 
time 


electric conductance 


028349523125 kg 
2.95735295625x 10-5 m? 
.031103475 kg 
2.8413075x10~5 m3 


3.08567818585x10'® m 
138254954376 kom 
Ss 


cd 
795.7747 15459 —— 


.0088097675 m?® 
6894.75729317 —Ko_ 
m:s@ 


.000473176473 m? 
.000946352946 m? 
-1591549343092 


Built-In Units 


Unit 


slug 


Name 
Stilb 


Slug 
Steradian 
Stere 


Stoke 


Sievert 

Metric ton 
Tesla 
Tablespoon 
EEC therm 
Short ton 

Long (U.K.) ton 
Torr 

Teaspoon 


Unified atomic mass 


Volt 
Watt 


Weber 


Int’l yard 
Square yard 
Cubic yard 
Year 
Degree 


Ohm 


Built-In Units 


Type 
luminance 


mass 
solid angle 
volume 


kinematic viscosity 


dose equivalent 
mass 

magnetic flux 
volume 

energy 


mass 
mass 


pressure 


volume 
mass 


electrical potential 


power 


magnetic flux 


length 

area 
volume 
time 

plane angle 


electric resistance 


Value 


cd 

me 
14.5939029372 kg 
.07957747 15459 
1m? 


10000 


1.47867647813x107 


105506000 ign 
Ss 


907.18474 kg 
1016.0469088 kg 


133.322368421 — 
ms 


5 m? 


4.92892159375x10~® m? 


1.66057x10~2” kg 
1 kam? 

A:s? 
1 kgm? 

s? 

1 kor? 

A-s? 
9144 m 
83612736 m? 
.764554857984 m? 
31556925.9747 s 


2.77777777778x10-3 


‘ kg:m? 
A2-s3 
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Messages 


This program (44 bytes, checksum #7EC6h) retrieves the text of 
a message given its number by generating the error, then using 
ERRM to get the text: 


* IFERR e DOERR 
THEH ERR 
EMD 


[Hex [Dec | General Messages 


Insufficient Memory 
Directory Recursion 
Undefined Local Name 
Undefined XLIB Name 
Memory Clear 

Power Lost 

Warning: 

Invalid Card Data 
Object In Use 

Port Not Available 


OANODOAARWDND — 


No Room in Port 


Object Not in Port 
Recovering Memory 

Try To Recover Memory? 
Replace RAM, Press ON 
No Mem To Config All 
No Room to Save Stack 
Can't Edit Null Char. 
Invalid User Function 

No Current Equation 
Invalid Syntax 
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[—Wex [bes [__Ob)eet Types 


Real Number 
Complex Number 
String 

Real Array 
Complex Array 
List 

Global Name 
Local Name 
Program 
Algebraic 
Binary Integer 
Graphic 
Tagged 

Unit 

XLIB Name 
Directory 
Library 
Backup 
Function 
Command 
System Binary 
Long Real 
Long Complex 
Linked Array 
Character 
Code 

Library Data 
External 
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Null message 

LAST STACK Disabled 
LAST CMD Disabled 
HALT Not Allowed 
Array 

Wrong Argument Count 
Circular Reference 
Directory Not Allowed 
Non-Empty Directory 
Invalid Definition 
Missing Library 

Invalid PPAR 

Non -Real Result 
Unable to Isolate 


Low Memory Messages 


No Room to Show Stack 
Warning 

Error: 

Purge? 

Out of Memory 
Stack 

Last Stack 

Last Commands 
Key Assignments 
Alarms 

Last Arguments 
Name Conflict 
Command Line 
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Messages 


Too Few Arguments 
Bad Argument Type 
Bad Argument Value 
Undefined Name 
LASTARG Disabled 


Incomplete Subexpression 
Implicit () off 
Implicit () on 


Positive Underflow 
Negative Underflow 
Overflow 
Undefined Result 
Infinite Result 


Invalid Dimension 
Invalid Array Element 
Deleting Row 
Deleting Column 
Inserting Row 
Inserting Column 


Invalid & Data 
Nonexistent DDAT 
Insufficient & Data 
Invalid SPAR 

Invalid & Data LN(Neg) 
Invalid & Data LN(O) 
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| Hex | Dec | Plot/Solve/Stat Messages 


Invalid EQ 

Current equation: 

No current equation. 
Enter eqn, press NEW 
Name the equation, press ENTER 
Select plot type 
Empty catalog 
undefined 

No stat data to plot 
Autoscaling 

Solving for 

No current data. Enter 
data point, press D+ 
Select a model 


Alarm Messages 


No alarms pending. 
Press ALRM to create 
Next alarm: 

Past due alarm: 
Acknowledged 

Enter alarm, press SET 
Select repeat interval 


1/0, Plot, Solve, Stat Messages . 


1/O setup menu 

Plot type: 

(OFF SCREEN) 

Invalid PTYPE 

Name the stat data, press ENTER 
Enter value (zoom out 

if >1), press ENTER 
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ee a 


Copied to stack 

x axis Zoom w/AUTO. 
X axis Zoom. 

y axis Zoom. 

x and y-axis Zoom. 
IR /wire: 

ASCII /binary: 

baud: 

parity: 

checksum type: 
translate code: 

Enter matrix, then NEW 
Bad Guess(es) 
Constant? 

Interrupted 

Root 

Sign Reversal 
Extremum 


Unit Management 


BOo1 2817 Invalid Unit 
Bo2 2818 Inconsistent Units 
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[Hex [Dee [170 and Printing 
Bad Packet Block Check 
Timeout 
Receive Error 
Receive Buffer Overrun 
Parity Error 
Transfer Failed 
Protocol Error 
Invalid Server Cmd. 
Port Closed 
Connecting 
Retry # 

Awaiting Server Cmd. 
Sending 

Receiving 

Object Discarded 
Packet # 

Processing Command 
Invalid IOPAR 

Invalid PRTPAR 

Low Battery 

Empty Stack 

Row 

Invalid Name 


Invalid Date 
Invalid Time 
Invalid Repeat 
Nonexistent Alarm 
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Menu Numbers 


The commands MENU, TMENU, and RCLMENU store and recall 
menu numbers in the form mm.pp, where mm is the menu 


number and pp is the page number. 


ODNAMARON=O| * 


LAST MENU 
CST 

VAR 

MTH 

MTH PARTS 
MTH PROB 

MTH HYP 

MTH MATRX 
MTH VECTR 
MTH BASE 

PRG 

PRG STK 

PRG OBJ 

PRG DISP 

PRG CTRL 

PRG BRCH 

PRG TEST 
PRINT 

1/O 

|/O SETUP 

[4] MODES 

[>] MODES 

[4] MEMORY 
[>] MEMORY 
[4] LIBRARY 
LIBRARY PORT 0 
LIBRARY PORT 1 
LIBRARY PORT 2 
(4) EDIT 

(4) SOLVE 


Menu Numbers 


SOLVE SOLVR 
(4) PLOT 
PLOT PTYPE 
PLOT PLOTR 
[4] ALGEBRA 
(4) TIME 
TIME ADJST 
TIME ALRM 
TIME ALRM RPT 
TIME SET 

(4) STAT 
STAT MODL 
(4) UNITS 
UNITS LENG 
UNITS AREA 
UNITS VOL 
UNITS TIME 
UNITS SPEED 
UNITS MASS 
UNITS FORCE 
UNITS ENRG 
UNITS POWR 
UNITS PRESS 
UNITS TEMP 
UNITS ELEC 
UNITS ANGL 
UNITS LIGHT 
UNITS RAD 
UNITS VISC 
(P) UNITS 
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Character Codes 


NUM CHR | NUM CHR} NUM CHR | NUM_ CHR 
32 64 ic 96 


1 7 2 re 
T 


OONOOAWNH OO 
m= 
ST tt oT 


rc aT Lae Co nNMs 
Lat. bt 


LO fa to wi ee me * # 
au 


eeu it om] Ts 
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NUM CHE al CHR | NUM CHR NUM eau, 


> Ir Te 
i te 


Py fe 
Tr: Te 
WP Le 


i wo i ee BS Sa 
2 in — $h2 Cr 


Te Te Te yy! fo ode: Ge de oe 


oe fat Eft 
Bee BS ee OM: OF OM. Mb ut FR Io 2: 


1m | 


a 
al 
5 
z 
o al 
+ 
+ 
* 4. 
tT 


Soy es oe oe. ee Th: 


0 
mob 
a 


Som te 
ite ith Ie 


ty 
IF: 


ir 
Yy -f. es es tie oe. me 


YO 


— fs = 


: ie 





The HP 48 character set can be remapped to match the HP 
82240A printer with the OLDPRT command. The character set is 
based on the ISO 8859 Latin 1 standard, except for characters 
127-159. 
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Object Types 


Real number 

Complex number 

String 

Real array 

Complex array C152) (3,4) ] 
List . "ABC" Var F 
Global name 

Local name 

Program 

Algebraic 

Binary integer 

Graphics object bese hic 131 x 64 
Tagged object 

Unit object 

XLIB name 

Directory 

Library Library 7éé6: 
Backup object Backup HOMED IR 
Built —in function SIH 

Built-in command SHAP 

System binary <2Alh> 

Extended real 

Extended complex 

Linked array 

Character Character 

Code object Code 

Library Data Library Data 
External object 
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Flags 


User flags are numbered 1 through 64. System flags are 
numbered from -1 through —64. By convention, application 
developers are encouraged to restrict their use of user flags to 
the range 31-64. 


All flags are clear by default, execpt for the wordsize (flags -5 — 
—10). 


The related commands SF, CF, FS?, FC?, FS?C, and FC?C 
are found in the : T menu. RCLF and STOF return 
or store a list of two binary integers representing the system and 
user flag sets. 






Flag Description Clear Set Default 


Principal Solution General solutions | Principal solutions 
Symbolic Constants Symbolic form Numeric form 
Numeric Results Symbolic results Numeric results 


Binary Integer Math Flags 


Binary integer wordsize n+1:0<n<63 
Flag —10 is the most significant bit 


-—13 and -—14 are not used. 
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Flag Description 
Coordinate System Flags 


Rectangular 
Cylindrical Polar 
Spherical Polar 


Degrees 
Radians 
Grads 


Vector/complex Vector 


Underflow Exception Return 0, 
set -23 or -—24 


Overflow Exception Return +MAXR, 
set -25 


Infinite Result Error Return +MAXR, 
set -26 
Pos. Underflow Ind. No Exception Exception 
Neg. Underflow Ind. No Exception Exception 
Overflow Indicator No Exception Exception 
Infinite Result Ind. No Exception Exception 


-26 
-27 through -29 are not used. 


Plotting and Graphics Flags 


-30 | Function Plotting f(x) y and f(x) f(x) 
Curve Filling Filling Enabled Filling Disabled | Enabled 
-32 | Graphics Cursor Visible Light Bkgnd | Visible Dark Bkgnd|_Light 
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Flag Description Default 


1/0 and Printing Flags 


1/0 Device Serial 

Printing Device IR Serial 

1/O Data Format ASCII Binary 

RECV Overwrite New variable Overwrite 

Double - Spaced Print Single Double 

Linefeed Inserts LF Suppresses LF 

Kermit Messages Msg Displayed | Msg Suppressed | Displayed 


Time Management Flags 


-40 |Clock Display TIME menu only All times TIME menu 
12 hour 24 hour 12 hour 
-42 |Date Format MM/DD/YY DD.MM.YY MM/DD/YY 
-43 |Rpt. Alarm Reschedule | Rescheduled | Not Rescheduled |Rescheduled 
-44 |Acknowledged Alarms Deleted Saved Deleted 


Notes: If flag —43 is set, unacknowledged repeat alarms are not rescheduled. 
If flag —44 is set, acknowledged alarms are saved in the alarm catalog. 


Display Format Flags 


-45 —|Set the number of digits in Fix, Scientific, and 
-48 |Engineering Modes 
Number 
Display Format 
-49 
and 


Fraction Mark Decimal Decimal 
Single Line Display Multi-line Single —line Multi-line 
Precedence () suppressed () displayed | Suppressed 
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fing [__Desrpton [Gar [Sette | 
Miscellaneous Flags 


Not used. 
Last Arguments 
Beep 

Alarm Beep 
Verbose Messages 
Fast Catalog Display 
Alpha Key Action 






































Twice to lock Once to lock Twice 








USR Key Action Twice to lock Once to lock Twice 
User Mode Not active Active Not active 
Vectored Enter Off On Off 


| 64 Set by GETI or PUTI when their element indices wrap around 


The HP 82211A HP Solve Equation Library application card uses 
three user flags: 


[re [seen [ome [ee [oe 


Units Type SI units English units SI units 


Units Usage Units used Units not used Units used 
Payment Mode End mode Begin mode End mode 
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Subject Index 


This index lists the commands and functions in the HP 48, 
grouped into subject areas. Some commands or functions 
appear more than once. 


BINARY INTEGER MATH 

AND Logical bit - by —bit AND 

ASR Arithmetic shift right 

B—R Binary —to —real conversion 
NOT One’s complement 

OR Logical bit -by-bit OR 

RCWS Recalls the binary integer wordsize 
RL Rotates left by one bit 

RLB Rotates left by one byte 

RR Rotates right by one bit 

RRB Rotates right by one byte 

R—-B Real-—to —binary conversion 

SL Shifts left by one bit 

SLB Shifts left by one byte 

SR Shifts right by one bit 

SRB Shifts right by one byte 

STWS Sets the binary integer wordsize 
XOR Logical bit -—by—bit XOR 


COMPLEX NUMBER OPERATIONS 


ABS 
ARG 


Subject Index 


V x2 + y? 

Returns the polar angle 6 of a coordinate pair (x,y) 
Complex conjugate 

Complex —- to -real conversion 

Symbolic constant i 

Returns imaginary part of a number or array 
Negates an argument 

Complex decomposition 

Returns the real part of a complex number 
Real-—to-—complex conversion 

Returns unit vector in the direction of the argument 
Separates (x,y) into x and y or r and 6 

Combines x and y into (x,y) or (r,6) if flag —19 is set 
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ARRAY & LIST OBJECT MANIPULATION 


ARRY— Separate array into individual elements 

—ARRY Combines numbers into an array 

CONVERT Performs a unit conversion 

DTAG Removes all tags from object 

EQ- Separates equation into left and right sides 

GET Gets an element from a list, array, or matrix 

GETI Gets an element from a list, increments and 
returns the index, and returns the list 

LIST— Separates a list into individual objects 

LIST Combines objects into a list 

OBJ— Decomposes a composite object into individual components. 

POS Finds an object in a list 

PUT Replaces an element in an array or list 

PUTI Replaces an element in an array or list and increments the index 

REPL Writes an object into another object 

SIZE Finds the number of elements in a list 

SUB Extracts a portion of a list 

—TAG Builds a tagged object 

—UNIT Builds a unit object 

—V2 Combines two real numbers into vector 

V3 Combines three real numbers into vector 

v- Separates a 2 or 3 element vector 

CONSTANTS 

i Symbolic constant i 

e Symbolic constant e 

MAXR Symbolic constant - maximum HP 48 real number 

MINR Symbolic constant-— minimum HP 48 real number 

rg Symbolic constant x 

CUSTOMIZATION 

ASN Make a single user —key assignment 

DELKEYS Clears user -—key assignments 

DEFINE Creates variable or user-defined function 

MENU Selects a built-in menu or creates a custom menu 

ORDER Rearranges the VAR menu 

RCLF Returns a list containing the system and user flags 

RCLKEYS Lists user —key assignments 

RCLMENU Recalls number and page of active menu 

STOF Sets system and user flags 

STOKEYS Makes multiple user -—key assignments 

TMENU Displays temporary built-in or list-defined menu 

126 Subject Index 


DATA ENTRY AND EDITING 


FREEZE 
INPUT 
KEY 
LAST 
LASTARG 
PROMPT 
TEXT 
WAIT 


Freezes up to three display areas 

Suspends program and waits for data 
Returns key in buffer 

Returns LAST arguments (if saved) 

Returns LAST arguments (if saved) 

Displays prompt and halts program 

Selects the stack display 

Pauses program execution or waits for a key 


DEBUGGING AND ERRORS 


DOERR Generates system or user — defined error 
ERRO Clears the last error number 

ERRM Returns the last error message 

ERRN Returns the last error number 

HALT Suspends program execution 

IFERR Begins IFERR test 

KILL Cancels all suspended programs 
LAST Returns arguments (if saved) 
LASTARG Returns arguments (if saved) 
DISPLAY MANAGEMENT 

CLLCD Clears the stack display 

DISP Displays an object on line n 

FREEZE Freezes up to three display areas 
GRAPH Enters the graphics environment 
INPUT Suspends program and waits for data 
PROMPT Displays prompt and halts program 
PVIEW Displays P/CT at specified coordinate 
TEXT Selects the stack display 
GENERAL MATH 

ABS Absolute value 

ARG Returns the polar angle @ of a coordinate pair (x,y) 
CEIL Next greater integer 

CONJ Complex conjugate 

FACT Factorial or gamma function 

FLOOR Next smaller integer 


Subject Index 
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Fractional part 

Adds in H.MS format 

Subtracts in H.MS format 

Converts a number from H.MS format 
Converts a number to H.MS format 
\nverse (reciprocal) 

. teger part 

Returns the mantissa of a number 
Returns the maximum of two numbers 
Returns the minimum of two numbers 
Modulo 

Negates an argument 

Converts number to fractional equivalent 
—Q after factoring out x 

Returns the real part of a complex number 
Rounds fractional part of number 

Finds a numerical root 

Computes a correction to the solution of a system of equations 
Radians — to -degrees conversion 

Sign of a number 

Squares a number 

Computes a Taylor series approximation 
Truncates number 

Returns the exponent of a number 
Returns x'" root of y 

Square root 

Integral 

Derivative 

Adds two objects 

Subtracts two objects 

Multiplies two objects 

Divides two objects 

Raises a number to a power 

Percent 

Percent change 

Percent total 


Subject Index 


GRAPHICS AND PLOTTING 


ARC 
AUTO 
AXES 

BAR 
BARPLOT 
BLANK 
BOX 
CENTR 
CLLCD 
CONIC 
C—PX 
DEPND 
DRAW 
DRAX 
ERASE 
FUNCTION 
GOR 
GRAPH 
—GROB 
GXOR 
HISTOGRAM 
HISTPLOT 
INDEP 
LABEL 
LCD— 
—LCD 
LINE 

NEG 
PARAMETRIC 
PDIM 
PICT 
PIXOFF 
PIXON 
PIX? 
PMAX 
PMIN 
POLAR 
PRLCD 
PVIEW 


Subject Index 


Draws an arc in PICT 
Scales y-axis 


Sets intersection of axes and optionally stores labels 


Selects bar plot 

Draws a bar plot of the data in ZDAT 
Creates a blank graphics object 

Draws a box in PICT 

Sets center of plot display 

Clears the stack display 

Selects conic plot 

User — unit to pixel coordinate conversion 
Specifies plot dependent column, variable, or range 
Draws a plot 

Draws axes 

Erases PICT 

Selects function plot 

Superimposes graphics objects 

Enters the graphics environment 

Converts object into graphics object 
Superimposes and inverts graphics objects 
Selects histogram plot 

Draws a histogram of the data in DAT 
Selects plot independent column, variable or range 
Labels axes 

Returns LCD as 131x64 pixel graphics object 
Displays graphics object 

Draws a line between two coordinates 
Inverts a graphics object 

Selects parametric plot 

Changes the size of PICT 

Returns the name PICT 

Turns off a pixel in PICT 

Turns on a pixel in PICT 

Tests a pixel in PICT 

Sets the upper-right plot coordinates 

Sets the lower —left plot coordinates 
Selects polar plot 

Prints an image of the display 

Displays P/CT at specified coordinate 
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PWRFIT Selects power curve - fitting model 

PX—C Pixel to user —unit coordinate conversion 

RCEQ Recalls the current equation 

REPL Writes one graphics object into another graphics object 
RES Sets the plot resolution in user unit or pixel intervals 
SCALE Specifies x and y scale in units per 10 pixels 
SCATRPLOT Draws a scatter plot of the data in DAT 

SCATTER Selects scatter plot 

SIZE Finds the dimensions of a graphics object 

STEQ Stores into reserved variable EQ 

SUB Extracts a sub-—grob 

TEXT Displays the stack display 

TLINE Toggles pixels on a straight line 

TRUTH Selects truth plot 

XCOL Specifies SDAT column as independent variable 
YCOL Specifies a DAT column as the dependent variable 
YRNG Specifies y-axis plotting range 

*H Adjusts the height of a plot 

*W Adjusts the width of a plot 

HYPERBOLIC OPERATIONS 

ACOSH Inverse hyperbolic cosine 

ASINH Inverse hyperbolic sine 

ATANH Inverse hyperbolic tangent 

COSH Hyperbolic cosine 

EXPM Natural exponential minus 1 

LNP1 Natural logarithm of (argument + 1) 

SINH Hyperbolic sine 

TANH Hyperbolic tangent 


INPUT/OUTPUT AND DATA TRANSFER 


BAUD 
BEEP 
BUFLEN 
CKSM 
CLOSEIO 
FINISH 
INPUT 
KERRM 
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Sets the baud rate 

Sounds a beep 

Returns number of characters in the serial buffer 
Select the checksum scheme 

Closes the serial port 

Terminates Kermit server mode 

Suspends program and waits for data 

Returns the last Kermit error message 


Subject Index 


KEY Returns key in buffer 


KGET Gets named data from a remote device 
OPENIO Opens IR or wired port 

PARITY Sets parity 

PKT Sends commands to server 

RECN Receives and renames file from remote Kermit 
RECV Receives file from remote Kermit, saved in a sender —named object 
SBRK Sends serial break 

SEND Sends object to another Kermit device 
SERVER Selects Kermit Server mode 

SRECV Reads characters from |/O port without Kermit 
STIME Sends serial transmit/receive timeout 
TRANSIO Selects character translation mode 

XMIT Sends string through |/O port without Kermit 


LOGARITHMIC OPERATIONS 


ALOG Antilogarithm 

e Symbolic constant e 

EXP Natural exponential 

EXPM Natural exponential minus 1 

LN Natural logarithm 

LNP1 Natural logarithm of (argument + 1) 
LOG Common (base 10) logarithm 
XPON Returns the exponent of a number 


LOGICAL AND RELATIONAL OPERATORS 


AND Logical or binary AND 

NOT Logical or binary NOT 

OR Logical or binary OR 

SAME Tests two objects for equality 
XOR Logical or binary XOR 

< Less -—than comparison 


< Less —than-—or-—equal comparison 

> Greater -than comparison 

> Greater — than -or-—equal comparison 
# Not-—equal comparison 

= Tests two objects for equality 
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MATRIX AND ARRAY OPERATIONS 


ABS Square root of sum of squares of elements 
ARRY— Separate array into individual elements 

—ARRY Combines numbers into an array 

CR Separates complex array into two arrays 

CNRM Column norm 

CON Creates a constant array 

CONJ Complex conjugate 

CROSS Cross product 

DET Determinant of a matrix 

DOT Dot product of two vectors 

GET Gets an element from a list, array, or matrix 

GETI Gets an element from a list, increments and 

IDN Creates an identity matrix 

IM Returns array of imaginary parts from complex array 
NEG Negates elements in an array 

PUT Replaces an element in an array or list 

PUTI Replaces an element in an array or list and increments the index 
R—C Combines two arrays into complex array 

RDM Redimensions an array 

RE Returns array of real parts from complex array 
RNRM Computes row norm of an array 

SIZE Finds the number of elements in an array or matrix 
SQ Squares a matrix 

TRN Transposes a matrix 

V2 Combines two real numbers into vector 

V3 Combines three real numbers into vector 

Vv Separates a 2 or 3 element vector 

MEMORY MANAGEMENT 

ARCHIVE Makes backup copy of HOME directory 

ATTACH Attaches library to current directory 

BYTES Returns the checksum and number of bytes of an object 
CLUSR Purges all user variables in the current directory 
CLVAR Purges all user variables in the current directory 
CRDIR Creates a directory 

DEFINE Creates user-defined function 

DETACH Detaches library from current directory 

FREE Frees merged memory 
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HOME 


LIBS Lists libraries attached to current directory 
MEM Returns available memory 

MERGE Merges RAM card with main memory 
NEWOB Separates object from list or backup name 
ORDER Rearranges the VAR menu 

PATH Returns a list showing the current path 
PGDIR Purges specified directory and its contents 
PURGE Purges one or more variables 

PVARS Returns list of port objects 

RCEQ Recalls the current equation 

RCL Recalls the contents of a variable 

RCLF Returns a list containing the system and user flags 
RCLZ Recalls the current statistics matrix 
RESTORE Replaces HOME directory with backup copy 
SAME Tests two objects for equality 

SIZE Finds the dimensions of an object 

STEQ Stores into reserved variable EQ 

STO Stores an object into a variable 

STOZ Stores into reserved variable [DAT 

TVARS Lists the variables of specified type 

TYPE Returns the type of an object 

UPDIR Makes parent directory the current directory 
VARS Returns list of variables in the current directory 
VTYPE Returns type of object in named variable 

a Assigns local variable (s) 

MODES AND FLAGS 

BIN Sets binary base 

CF Clears a system or user flag 

DEC Sets decimal base 

DEG Sets Degrees mode 

ENG Sets Engineering display mode 

FC? Tests a system or user flag 

FC?C Tests and clears a system or user flag 

FIX Sets Fix display mode 

FS? Tests a system or user flag 

FS?C Tests and clears a system or user flag 
GRAD Sets Grads mode 

HEX Sets hexadecimal base 
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Selects the HOME directory 
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OCT Sets octal base 
RAD Sets Radians mode 
RCLF Returns a list containing the system and user flags 
SCI Sets Scientific display mode 
SF Sets a system or user tlag 
STD Sets Standard display mode 
STOF Sets system and user flags 
PRINTING 
CR Prints a carriage —right 
DELAY Sets 0 <n<6.9 sec delay between printed lines 
OLDPRT Remaps to HP 82240A character set 
PRLCD Prints an image of the display 
PRST Prints the stack 
PRSTC Prints the stack in compact format 
PRVAR Prints the name and contents of one or more variables 
PR1 Prints an object 
PROBABILITY 
COMB Combinations of n objects taken r at a time 
FACT Factorial or gamma function 
! Factorial or gamma function 
PERM Permutations of n objects taken r at a time 
RAND Returns a random number 
RDZ Sets the random number seed 
UTPC Upper -tail Chi- Square distribuion 
UTPF Upper — tail F — distribution 
UTPN Upper - tail normal distribution 
UTPT Upper —tail t—distribution 


PROGRAM BRANCHING AND CONTROL 


CASE 
CONT 
DO 
DOERR 
ELSE 
END 
EVAL 
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Begins CASE structure 
Continues a halted program 
Begins DO loop 

Generates user-defined error 
Begins ELSE clause 

Ends program structures 
Evaluates an object 
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FOR 


Begins FOR loop 


HALT Suspends program execution 

IF Begins IF test 

IFERR Begins IFERR test 

IFT IF ... THEN ... END test 

IFTE IF ... THEN ... ELSE ... END test 

INPUT Suspends program and waits for data 
KILL Cancels all suspended programs 

NEXT Ends FOR ... NEXT or START ... NEXT 
—NUM Evaluates an object to yield a numeric result 
OFF Turns the calculator off 

PROMPT Displays prompt and halts program 
REPEAT Part of WHILE ... REPEAT ... END 

START Begins START ... NEXT or START ... STEP 
STEP Ends FOR... STEP or START ... STEP 
SYSEVAL Executes a system object 

THEN Begins THEN clause 

UNTIL Part of DO... UNTIL... END 

UPDIR Makes parent directory current directory 
WAIT Pauses program execution or waits for a key 
WHILE Begins WHILE ... REPEAT ... END 
WSLOG Returns the four most recent system halts 
Assigns local variable (s) 

STACK MANIPULATION 

—ARRY Combines numbers into an array 

CLEAR Clears the stack 

DEPTH Counts the objects on the stack 

DROP Drops one object from the stack 

DROPN Drops n+1 objects from the stack 
DROP2 Drops two objects from the stack 

DUP Duplicates one object on the stack 

DUPN Duplicates n objects on the stack 

DUP2 Duplicates two objects on the stack 
LAST Returns LAST arguments (if saved) 
LASTARG Returns LAST arguments (if saved) 
—LIST Combines objects into a list 

OVER Copies the object in level 2 into level 1 
PICK Copies nth object into level 1 (excluding n) 
ROLL Moves level n+1 object to level 1 

ROLLD Moves the level 2 object to level n 

ROT Moves the level 3 object to level 1 

SWAP Swaps the objects in levels 1 and 2 
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STATISTICS 


BAR 
BARPLOT 
BESTFIT 
BINS 

CLZ 
CNRM 
COL 
CORR 
COV 
EXPFIT 
HISTOGRAM 
HISTPLOT 
LINFIT 
LOGFIT 
LR 

MAX 
MEAN 
MIND 

Nx 
PREDV 
PREDX 
PREDY 
PWRFIT 
RCLZ 
SCATRPLOT 
SCATTER 
SDEV 
STOZ 
TOT 

VAR 
XCOL 
YCOL 
XRNG 

>» 

XLINE 

=X 

=X*2 

LY 

xY*2 
uX*Y 

r+ 

Sic 
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Selects bar plot 

Draws a bar plot of the data in 2DAT 

Executes LR and computes the best curve fit 
Sorts XDAT data into histogram bins 

Purges the statistics matrix 

Computes the column norm of an array 

Specifies dependent and independent columns in [DAT 
Correlation coefficient 

Covariance 

Selects exponential curve — fitting model 

Selects histogram plot 

Draws a histogram of the data in [DAT 

Selects linear curve —fitting model 

Selects logarithmic curve - fitting model 

Computes linear regression 

Finds the maximum coordinate values in [DAT 
Computes means of the data in [DAT 

Finds the minimum coordinate values in [DAT 
Returns the number of data points in [DAT 
Predicted dependent variable value 

Predicted independent variable value 

Predicted dependent variable value 

Selects power curve - fitting model 

Recalls the current statistics matrix 

Draws a scatter plot of the data in [DAT 

Selects scatter plot 

Computes standard deviations of the data in [DAT 
Stores into reserved variable [DAT 

Sums the columns in SDAT 

Computes variances of the data in [DAT 

Specifies EDAT column as the independent variable 
Specifies a [DAT column as the dependent variable 
Specifies x-axis plotting range 

Summation 

Returns best-fit line for data in [DAT 

Sum of data in independent ZDAT column 

Sum of squares in independent EDAT column 

Sum of data in dependent ZDAT column 

Sum of squares of data in dependent ZDAT column 


Sum of products in independent and dependent DAT columns 


Appends one or more data points to [DAT 
Deletes last row from DAT 


Subject Index 


STRING MANIPULATION 


CHR Makes a one -—character string 

NUM Returns character code of a string’s first character 
POS Finds a substring in a string 

SIZE Finds the number of characters in a string 

STR— Parses and evaluates a string 

—STR Converts an object to a string 

SUB Extracts a portion of a string 

SYMBOLIC MANIPULATION 

APPLY Returns an evaluated expression as the 

argument to an unevaluated local name 

COLCT Collects like terms 

EQ- Separates equation into left and right sides 

EXPAN Expands an algebraic 

e Symbolic constant e 

i Symbolic constant i 

x Symbolic constant x 

ISOL Isolates a variable in an equation 
TMATCH Match -and-replace, beginning with subexpressions 
{MATCH Match —-and-replace, beginning with the top —level expression 
—NUM Evaluates an object to yield a numeric result 

OBJ— Separates outermost function and its arguments 
QUAD Solves a quadratic polynomial 

QUOTE Returns argument expression unevaluated 

SHOW Resolves all references to a name implicit in an algebraic 
TAYLR Computes a Taylor series approximation 

J Integral 

) Derivative 


"Where": appends local name and value to evaluated expression 


TRIGONOMETRIC OPERATIONS 


ACOS 
ASIN 
ATAN 
Cos 
D—R 
R—D 
SIN 
TAN 
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Arc cosine 

Arc sine 

Arc tangent 

Cosine 

Degrees — to —radians conversion 
Radians - to —-degrees conversion 
Sine 

Tangent 
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TIME AND ALARMS 


ACK Acknowledges displayed past due alarm 
ACKALL Acknowledges all past due alarms 
CLKADJ Add clock ticks to the system time 
DATE Returns the system date 

—DATE Sets the system date 

DATE+ Adds a number of days to a date 
DDAYS Number of days between two dates 
DELALARM Deletes an alarm 

FINDALARM Returns alarm index n 

HMS + Adds in H.MS format 

HMS- Subtracts in H.MS format 

HMS— Converts a number from H.MS format 
—HMS Converts a number to H.MS format 
RCLALARM Recalls alarm from alarm list 

STIME Sends serial transmit/receive timeout 
STOALARM Stores alarm in system alarm list 

TICKS Returns time in binary integer clock ticks 
TIME Returns current time as number 

—TIME Sets specified system time 

TSTR Converts date & time numbers to string form 
UNIT OBJECT OPERATIONS 

CONVERT Performs a unit conversion 

OBJ— Decomposes a unit object into a number and unit expression 
UBASE Converts unit object to SI base units 
UFACT Factors specified compound unit 

—UNIT Builds a unit object 

UVAL Returns scalar portion of unit object 
VARIABLE ARITHMETIC 

DECR Decrements value of specified variable 
INCR Increments and returns value of variable 
SCONJ Conjugates the contents of a variable 
SINV Inverts the contents of a variable 

SNEG Negates the contents of a variable 

STO+ Storage arithmetic add 

STO- Storage arithmetic subtract 

STO* Storage arithmetic multiply 

STO/ Storage arithmetic divide 
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Command Reference 


This command reference lists the stack diagrams for all 
commands and functions in the HP 48. Each entry lists the name, 
characteristics, description, and stack diagrams if applicable. 


NAME Characteristics 
Description 


Input Output 


Level, Level, Level, -—+ Level, Level, Level, 


Note: 
Notes about the function or command 





The characteristics are encoded as follows: 


Invertible 
Differentiable 
Integrable 





For instance, ACOSH is a function which has an inverse and is 
differentiable: 


ACOSH | 0 Function 


Inverse hyperbolic cosine 


z-— acosh z 
*symb’ -—+ ’'ACOSH(symb)’ 





The following table lists the terms used in the stack diagrams. Note 
that system modes may affect the interpretation of input parameters 
or the results of some functions. 
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obj Any object 

xory Real number 

abcd Real number 

(xy ) Complex number 

z Real or complex number 

morn Positive integer real number (rounded if non—integer) 
#nor#m | Binary integer 

x_unit Real number with units 

X_pa-unit Real with planar angular units 

“string” Character string 

{list} List of objects 

grob Graphics object 

{ #x #y}]| Pixel coordinates 

hms Real number in HH.MMSS format 

time Time in HH.MMSS format 

repeat Repeat interval in clock ticks (8192 ticks per second) 
date Date in current MM.DDYYYY or DD.MMYYYY format (flag - 42) 
T/F Test result: 0 (false) or non-zero (true) 

*symb’ Expression or name treated as an algebraic 

[vector] Real or complex vector 

[[matrix]] Real or complex matrix 

[R-array] Real vector or matrix 

[C-array] Complex vector or matrix 

{row col} Coordinates of an element in a matrix 


position Real number specifying an element in a list, vector, 
or matrix. May be a list containing two real 
numbers specifying an element in a matrix. 


‘name’ Global or local name 

’global’ Global name 

re or rc.p Key location: row-—col or row-—col.plane (see User Keys) 
mm.pp Menu specified as menu.page 

d.o.f. Positive integer degrees of freedom 

port Port number: 0, 1, 2, or & (wildcard) 

backup Backup object 

library Library object 

LID Library identifier (port:library number) 
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ABS 


Oo Function 


Absolute value. The absolute value of a vector or matrix is the 
square root of the sum of squares of the absolute values of 


the elements. 
x 
(xy ) 
[vector] 
[[matrix]] 
*symb’ 
x_unit 


ACK 


Acknowledges displayed past due alarm 


ACKALL 


Acknowledges all past due alarms 


ACOS 


Arc cosine 


ACOSH 
Inverse hyperbolic cosine 


Zz 
*symb’ 


ALOG 
Antilogarithm 


AND 
Logical or binary AND 
#N, #No 
x y 
x ‘symb’ 
*symb’ x 
‘symb,' ‘symb,’ 
"string," "strings" 
Note: 


ee oe 


pode ah pe A 


thee 
x? + y? 


| vector | 
| matrix | 
‘ABS(symb)’ 
|x |_unit 


Command 


Command 


| df Function 


acos z 
"ACOS(symb)’ 


| 0 Function 


acosh z 
"ACOSH(symb)’ 


| 0 sf Function 


107 
*ALOG(symb)’ 


Function 


#N3 

T/F 

*x AND symb’ 
*symb AND x’ 
*symb, AND symb,’ 
"string," 





String arguments must have the same length 
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APPLY 0 Function 


Returns an evaluated expression as the argument to an 
unevaluated local name 


{ symb, ... symb, } ‘name’ — ‘name( symb,, ... , symb,, )’ 
"APPLY (name,symb,, ..., symb,)’ 


ARC Command 


Draws an arc in PICT centered at (x,y ), radius r, counterclockwise 
from 6, to 65 


(sy) Fr 6, 6 — 
{#x#y} #r 6, & —- 


ARCHIVE Command 
Makes backup copy of HOME directory 


10: name — 
in:name — 


ARG Oo Function 
Returns the polar angle 6 of a coordinate pair (x,y) 
z—7 6 


‘symb’ — "ARG(symb)’ 
ARRY— Command 


Separate array into individual elements 
[vector] — Zz + Z,_ {N} 
[[matrix]] —* = 244 Z42++. Zam {N M} 


—ARRY Command 
Combines real or complex numbers into an array 
Zy..Z, NM —> — [vector] 
Zi, Zins Zoe 1AM} [[matrix]] 


ASIN | df Function 


Arc sine 

asin z 

"ASIN(symb)’ 
ASINH | d Function 
Inverse hyperbolic sine 


asinh z 
*ASINH(symb)’ 
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ASN Command 
Make a single user —key assignment 


object rop — 
*SKEY’ rc.p —  Reactivates standard key 


ASR Command 
Arithmetic shift right (preserves most significant bit) 
#n, — #M5 


ATAN | df Function 
Arc tangent 

atan z 

"ATAN(symb)’ 
ATANH | 0 Function 
Inverse hyperbolic tangent 


z atanh z 
‘symb’ "ATANH(symb)’ 


ATTACH Command 
Attaches library to current directory 
library-number — 


AUTO Command 


Scales y-axis 


AXES Command 


Sets intersection of axes and optionally stores labels 


(xy) 
{(%y)} —- 
{ "Xlabel" "Ylabel"}| — 


{ (xy) "Xlabel" "Ylabel" } 


BAR Command 
Selects bar plot 


BARPLOT Command 
Draws a bar plot of the data in EDAT 
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BAUD Command 
Sets the serial baud rate: 1200, 2400, 4800, or 9600 (default) 
n _ 
Note: 
The clock should not be displayed during 9600 baud transfers. 


BEEP Command 


Sounds a beep. Maximum 4400 Hz, 1048 seconds. 
Hz secs — 


BESTFIT Command 
Selects the statistics model that yields the largest correlation 

coefficient and executes the LR command 

BIN Command 


Sets binary base 


BINS Command 
Sorts the EDAT data into N bins using the independent variable 

column as the sort key. The level 1 result shows the number of 

data points less than and greater than the available bins. 


Xmin Width No > [[by]...[by}] [b, be] 


BLANK Command 


Creates a blank graphics object 
#width #height —> = grob 


BOX Command 


Draws a box in P/CT with opposite corners defined by user -—unit 
or pixel coordinates 


(xy) («y') 
{#x #y} {#x’ #y’'} — 
BUFLEN Command 
Returns the number of characters in the serial buffer 
—> on T/F 
BYTES Command 
Returns the checksum and number of bytes of an object 


‘global’ — checksum size 
object — checksum size 
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B—R Command 
Binary -to—real conversion 


CASE Command 
Begins CASE structure 
CASE 


test, THEN action, END 
test, THEN action, END 


test, THEN action, END 
default action 


CEIL Function 
Next greater integer 
x — On 
‘symb’ —+ ~~ 'CEIL(symb)’ 
x_unit — ~~ n_unit 
CENTR Command 
Sets center of plot display. Supplying x implies (x,0). 
(xy) — 
x _ 
CF Command 
Clears a system or user flag 
+n 
CHR Command 
Makes a one -character string 
"string" 


CKSM Command 


Select the checksum scheme 


1-digit arithmetic 
2-digit arithmetic 
3-digit-CRC (default) 
CLEAR Command 


Clears the stack 





objects 
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CLKADJ Command 
Add clock ticks to the system time (8192 ticks per second) 
+ticks — 


CLLCD Command 
Clears the stack display 


CLOSEIO Command 


Closes the serial port, clears input buffer and KERRM 


CLUSR Command 
CLVAR 


Purges all user variables in the current directory 


CLE Command 


Purges the statistics matrix 


CNRM Command 


Computes the maximum value of the sums of the absolute values 
of all elements over all columns 


[vector] —+  column-norm 
[[matrix]] — | column-norm 


Note: 
Since a vector is considered a 1-—row matrix, CNRM returns the 
sum of the absolute values of the elements in the vector. 
COLCT Command 
Collects like terms 
Zh. Zz 
‘symb,’ — *symb,’ 
COLE Command 
Specifies dependent and independent columns in [DAT 
independent dependent — 


COMB Function 
Combinations of n objects taken m at a time 
nm —+ Com 
‘symb’ n -— ‘’COMB(symb,n)’ 
n ‘symb’ —+ ’COMB(n,symb)’ 
‘symb,’ ‘symb,’ —+  '‘COMB(symb,,symb,)’ 
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CON 


Command 


Creates a constant array or replaces the contents of an existing 


array or named array 


{rows cols} 
[vector,] 
[[matrix,]] 
‘name’ 


CONIC 


Selects conic plot 


CONJ 
Complex conjugate 
Xx 
(x,y ) 
[R-array] 
[C-array,] 
*symb’ 


CONT 


Continues a halted program 


CONVERT 
Performs a unit conversion 
x_ old y new 
x y_pa-unit 
xX _pa-unit y 
x y 
CORR 


> 
—> 
—> 
—>- 


[[matrix]] 
[vectors] 
[[matrix,]] 


Command 


| 0 Function 


Xx 
( x,—-y ) 
[R-array] 
[C-array5] 
*CONJ(symb)’ 


Command 


Command 


x’ new 

x’ _pa-unit 
x”’_pa-unit 
x 


Command 


Correlation coefficient of SDAT data in columns specified by COLD 


z 
*symb’ 
X_pa-unit 
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correlation 


| df Function 


cos z 
*COS(symb)’ 
cos x 
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COSH | dfs Function 
Hyperbolic cosine 

cosh z 

*"COSH(symb)’ 
COV Command 
Covariance of ZDAT data in columns specified by COLE 

— covariance 

CR Command 


Prints a carriage —right 


CRDIR Command 


Creates a directory 


CROSS Command 
Cross product 
[A][B] — [A x B] 
C—-PX Command 
User —unit to pixel coordinate conversion 
(xy) — {#col #row } 
C—R Command 
Complex —to —real conversion 
(xy ) x y 
[C-array] [R-arrayreail [R-arrayimag] 


DATE Command 


Returns the system date 


—DATE Command 


Sets the system date 


DATE + Command 
Adds a number of days to a date 
date #days 


DDAYS Command 
Number of days between two dates 
date, date, — 
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DEC Command 


Sets decimal base 


DECR Command 
Decrements value of specified variable 
‘name’ — = x 
DEFINE Command 
Creates user-defined function 
‘equation’ — 

DEG Command 
Sets Degrees mode 
DELALARM Command 
Deletes one alarm or all alarms from the system alarm list 

n -—+ Deletes specified alarm 

0 — Deletes all alarms 
DELAY Command 


Sets 0 <n<6.9 second delay between printed lines (1.8 second default) 


DELKEYS Command 


Clears user —key assignments 


Clears a single key 

Clears a list of keys 

Clears standard key definitions 
Clears list of keys & std key defs 
Clears all user keys 


DEPND Command 
Specifies plot dependent column, variable, or range 


n 
‘name’ — 

{name} — 

start end — 

{ start end} — 
{name start end} — 


DEPTH Command 
Counts the objects on the stack 
objects objects n 
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DET Command 
Determinant of a square matrix 
[[matrix]] —+ determinant 


DETACH Command 
Detaches library from current directory 
library-—number — 


DISP Command 


Displays an object in medium font (5x7) on line n, where n=1 
is the top line, n=7 is the bottom line 


object n — 


DO Command 


Begins DO loop 
DO loop-clause UNTIL test-clause END 


DOERR Command 


Generates system or user-defined error 


0 — ~~ Simulates [ATTN] 
n Issues machine error n 


—_ 
#n — Issues machine error n 
—_ 


"string" 
DOT Command 
Dot product of two vectors 
[A][B] — 
DRAW Command 
Draws a plot 


DRAX Command 


Draws axes 


DROP Command 
Drops one object from the stack 
object — 


DROPN Command 
Drops n and n objects from the stack 
Obj, ... obj; n — 


Issues string error 
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DROP2 Command 
Drops two objects from the stack 
obj, obj; — 


DTAG Command 
Removes all tags from object 
‘tag:obj — obj 


DUP Command 
Duplicates one object on the stack 
obj — obj obj 


DUPN Command 
Duplicates n objects on the stack (excluding n) 
obj, ... Obj; Nn — Obj, ... Obj, Obj, ... obj, 


DUP2 Command 
Duplicates two objects on the stack 
obj, objy —+ obj, Obj, obj, obj, 


D—R Function 
Degrees - to —-radians conversion 
x — (x/180)x 
‘symb’ — *D—R(symb)’ 


e J Function 
Symbolic constant e 


2.71828182846 


ELSE Command 


Begins false —clause in IF ... THEN ... ELSE ... END 
or IFERR... THEN ... ELSE ... END 


END Command 


Ends program structures 


ENG Command 
Sets Engineering display mode 


n —> 
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EQ-— Command 
Separates equation into left and right sides 
‘symb,=symb,’ —+ ‘symb,’ ‘symb,’ 
z—7 20 
‘name’ — ‘name’ O 
x_unit —+ x_unit 0 


ERASE Command 
Erases PICT 


ERRM Command 
Returns the last error message 

“error message" 
ERRO Command 


Clears the last error number 


ERRN Command 


Returns the last error number 


EVAL Command 


Evaluates an object 
obj 
:port:name 
sport: {path name} 
{ port:name, port:name,... } 


EXP | df Function 
Natural exponential 

exp z 

"EXP(symb)’ 
EXPAN Command 


Expands an algebraic 


EXPFIT Command 
Selects exponential curve -fitting model 

EXPM | of Function 
Natural exponential minus 1 


x —> ~~ exp(x)-1 
‘symb’ — *EXPM(symb)’ 
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FACT Function 
Factorial or gamma function 
n n! 
Xx T(x +1) 
*symb’ *FACT(symb)’ 


Command 


FC?C Command 
Tests and clears a system or user flag 
+1 — 


FINDALARM Command 
Returns alarm index n 


First alarm due after a date and time: 
{ date time} — n 


First alarm due on a specified date: 
date — 


First past due alarm: 


FINISH Command 


Terminates Kermit server mode. 


FIX Command 
Sets Fix display mode 


FLOOR Function 
Next smaller integer 

n 

*FLOOR(symb)’ 

n_unit 
FOR Command 
Begins FOR loop 


start end FOR counter loop-clause NEXT 
start end FOR counter loop-clause increment STEP 
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FP Function 
Fractional part 


y 
’FP(symb)’ 
y_unit 


FREE Command 
Frees merged memory 
LID port 


{ } port 
:port:name 


{ :port:names ... LIDs } port 
FREEZE Command 


Freezes up to three display areas. The least significant bits control 
which area will be frozen. 


Status area 
Stack & command line 
Menu area 


FS? Command 
Tests a system or user flag 


FS?C 
Tests and clears a system or user flag 
+n — = T/F 


FUNCTION Command 


Selects function plot 


GET Command 
Gets an element from a list, vector, or matrix 
{ list } position object 
‘name’ position object 
[vector] position z 
[[matrix]] position z 
[[matrix]] {row col } z 
‘name’ {row col } z 
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GETI Command 


Gets an element from a list, increments and returns the position, and 
returns the list 
{ list }} position — {list} position’ object 
‘name’ position -—+ ‘name’ position’ object 
[vector] position — [vector] position’ z 
[[matrix]] position — [[matrix]] position’ z 
[[matrix]] {row col} — [[matrix]] { row col’} z 
‘name’ {row col} -—+ ‘name’ {row col’} z 


GOR Command 
Superimposes grob’ onto grob at the specified coordinates 
grob (x,y) grob’ -—+ ~— grob” 
grob { #x#y} grob’ -—+ — grob” 
PICT (x,y) grob’ — 
PICT {#x#y} grob’ — 


GRAD Command 


Sets Grads mode 


GRAPH Command 


Enters the Graphics environment until [ATTN] is pressed 


—GROB Command 
Converts object into graphics object 
object n -— — grob 


EquationWriter picture 
Small font (3x5) 
Medium font (5x7) 
Large font (5x9) 


GXOR Command 
Superimposes and inverts grob’ onto grob at the specified coordinates 
grob (x,y) grob’ -—+ — grob” 
grob { #x #y} grob’ -—+ = grob” 
PICT (x,y) grob’ — 
PICT {#x#y} grob’ — 
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HALT Command 


Suspends program execution 


HEX Command 


Sets hexadecimal base 


HISTOGRAM Command 


Selects histogram plot 


HISTPLOT Command 
Draws a histogram of the data in SDAT 


HMS+ Command 


Adds in H.MS format 
hms, hms, — ~~ hms, +hms, 


HMS - Command 
Subtracts in H.MS format 
hms, hms, 


HMS— Command 
Converts a number from H.MS format 


— 


—HMS Command 
Converts a number to H.MS format 


xX —_ 


HOME Command 
Selects the HOME directory 


i d Function 
Symbolic constant j 


IDN Command 


Creates an identity matrix 


n [[n x n real —identity — matrix]] 
[[matrix]] [[identity — matrix]] 
‘name’ replaces named matrix 
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IF Command 
Begins IF test 

IF test THEN true -clause END 

IF test THEN true —clause ELSE false -clause END 
IFERR Command 
Begins IFERR test 

IFERR test THEN true-clause END 

IFERR test THEN true —clause ELSE false -clause END 
IFT Command 
IF ... THEN ... END test. Executes object if T/F is true. 

T/F object — 


IFTE Oo Function 


IF... THEN ... ELSE ... END test. Executes true -obj if T/F is true, 
otherwise executes false -obj. 
T/F true-obj false-obj — 
*symb’ true-obj false-obj — 
"IF TE(symb, true — obj, false — obj)’ 


IM Function 
Returns imaginary part of a number or array 
x 0 


(x,y ) y 
[R-array] [zero R-array] 
[C-array] [R-array] 
*symb’ *IM(symb)’ 


INCR Command 


Increments and returns value of variable 
‘name’ — 


INDEP Command 
Specifies plot independent column, variable or range 
n 
‘name’ 
{ name } 
start end 
{ start end } 
{name start end } 
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INPUT 


Command 


Suspends program, displays message, and waits for data. mode can 
be ALG, a, or V. The level 1 list may contain any of the options in 


any order. 


“message 


prompt" — "result" 


"message" { "prompt" column mode } — "result" 
"message" { "prompt" { rowcol } mode} — "result" 


INV 
Inverse (reciprocal) 
z 
[[matrix]] 
*symb’ 
x_unit 
IP 
Integer part 


ISOL 
Isolates a variable in an equation 
*symb,’ ‘global’ 


KERRM 


Returns the last Kermit error message 


KEY 


| df Function 


1/z 
[[1/matrix]] 
*"INV(symb)’ 
1/x_1/unit 


Function 


n 
"IP(symb)’ 
n_unit 


Command 


Command 


“message” 


Command 


Returns 0 if no key in has been pressed, otherwise 1 in level 1 and 


the keycode in level 2. 


KGET 


Gets named data from a remote device 


0 


Command 


‘name’ 
"name" 


{ remote —name local-name } 


{ name, name, ... } 


{ { remote —name, local-name, } name, ... } 
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KILL Command 


Cancels all suspended programs 


LABEL Command 


Labels axes 


LAST Command 
LASTARG 
Returns arguments (saved if flag —55 is clear) 

—  Last-Argument(s) 
LCD— Command 
Returns LCD as 131x64 pixel graphics object 

md grob 
—LCD Command 
Displays graphics object at the upper —left corner of the display 

grob — 


LIBS Command 


Lists library objects attached to current directory 


— { "title," library-number, port, ... } 


LINE Command 
Draws a line between two coordinates 
(xy) (xy) — 
{ #x, #y,} {#x. #y.} 
LINFIT Command 


Selects linear curve — fitting model 


LIST— Command 
Separates a list into individual objects 

{ obj, ... obj, } —>  obj,... obj, n 
—LIST Command 
Combines objects into a list 

obj, ... obj, n — { obj, ... obj, } 
LN | df Function 
Natural logarithm 


Inz 
*LN(symb)’ 
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LNP1 | 8 Function 
Natural logarithm of (argument + 1) 
x —  In(1+x) 
‘symb’ —+ ’LNP1(symb)’ 
LOG | of Function 
Common (base 10) logarithm 
z7- log z 
‘symb’ —+ ‘LOG(symb)’ 
LOGFIT Command 


Selects logarithmic curve —fitting model 


LR Command 
Computes linear regression of ZDAT data 
— intercept slope 


MANT Function 
Returns the mantissa of a number 
x — y 


‘symb’ —+ ‘'MANT(symb)’ 


tMATCH Command 
Match-and-replace, beginning with subexpressions 
‘symb’ { 'pattern’ ‘replacement’} — ‘result’ T/F 
*symb’ { ’pat’ ’repl’ ’conditional’} — ‘result’ T/F 
|MATCH Command 
Match -and-replace, beginning with the top-level expression 
‘symb’ { ‘pattern’ ‘replacement’} — ‘result’ T/F 
‘symb’ { ’pat’ ’repl’ ’conditional’} — ‘result’ T/F 
MAX Function 
Returns the maximum of two numbers 
x y max (x,y) 
x ’symb’ *MAX(x,symb)’ 
*symb’ x *MAX(symb,x)’ 
*symb,’ *symb,’ *MAX(symb,,symb,)’ 
x y_pa-unit max(x, UBASE(y)) 
X_pa-unit y max (UBASE(x),y) 
x_unit y_unit max(x,y)_unit 
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MAXR d Function 
Symbolic constant-— maximum HP 48 real number 

—  9.99999999999E499 
MAX> Command 
Finds the maximum column values of the data in [DAT 

=) 2X 

me Kg cen Men | 


MEAN Command 
Computes means of the data in SDAT 


—_ x 


MEM Command 


Returns available memory 


MENU Command 


Selects a built—in menu or creates a custom menu (see Menus) 


mm.pp = 
‘list-name’ — 
{ names and commands} — 
MERGE Command 
Merges RAM card with main memory 
port — 


MIN Function 
Returns the minimum of two numbers 

x y 

x ’symb’ 

*symb’ x 

*symb,’ ‘symb,’ 

x y_pa-unit 

X_pa-unit y 

x_unit y_unit 


min(x,y) 
*MIN(x,symb)’ 
*MIN(symb,x)’ 
*MIN(symb,,symb,)’ 
min(x, UBASE(y)) 
min(UBASE (x), y) 
min(x,y)_unit 


De oe es ee ee 
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MINR 0 Function 


Symbolic constant- minimum HP 48 real number 
nd 1.E-499 


MIND Command 
Finds the minimum column values of the data in EDAT 

> =X 

md [ X4 2+ Xm J 


Function 


x y x mod y 
x ‘symb’ *MOD(x,symb)’ 
*symb’ x ’"MOD(symb,x)’ 
‘symb,’ ‘symb,’ *MOD(symb,,symb,)’ 


NEG | 8 Function 
Negates an argument 

z 

#n, 

x_unit 

[vector] 

[[matrix]] 

“symb’ 


-Z 
#Nnz (two’s complement) 
-x_unit 

[-vector] 

[[-matrix]] 

"—(symb)’ 

grob inverted —grob 

PICT inverts PICT 


NEWOB Command 

Separates object from list or backup object (see Temporary Memory) 
object — object 

NEXT Command 

Ends FOR... NEXT or START... NEXT 


NOT Function 
Logical or binary NOT 


> 
> 
—> 
> 
> 
> 
—> 
—_— 


#n, #No 
Xx T/F 
*symb’ "NOT(symb)’ 
"string," "string" 
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NUM Command 
Returns character code of a string’s first character 
“string’ —> on 


—NUM Command 
Evaluates an object to yield a numeric result 
object — z 
N> Command 
Returns the number of data points in SDAT 
—> on 
OBJ— Command 


Decomposes a composite object into individual components. String 
objects are executed as a command line after the "" delimiters have 
been removed. 


:tag:object 7 
(xy ) 
x_units 
x +Y’ 
[X1.. X_ ] 
[[ X44 X42 +++ Xam }] 
{ obj, ... obj, } 
"string" 
OCT Command 
Sets octal base 
OFF Command 
Turns the calculator off 
OLDPRT Command 
Remaps printer output to the HP 82240A character set 


OPENIO Command 


Opens IR or wired port 


object "tag 


xy 
x 1_units 


— 
— 
—- 
— 
—> 
mah’ 
> 
—> 





Command Reference 163 


OR Command 


Logical or binary OR 
#n, #2 
x y 
x ’symb’ 
‘symb’ x 
"symb,’ ’symb,’ 
"string," "strings" 


#N3 

T/F 

*x OR symb’ 
*symb OR x’ 
*symb, OR symb,’ 
"strings" 


ie ae ae oe 


Note: 
String arguments must have the same length 


ORDER Command 
Rearranges the VAR menu 
{names} — 


OVER Command 
Copies the object in level 2 into level 1 
Obj2 obj; —+ Objp Obj, Obj, 


PARAMETRIC Command 


Selects parametric plot 


PARITY Command 
Sets parity. n<0 indicates transmit parity only. 
n — 


none 
odd 
even 
mark 
space 


PATH Command 


Returns a list showing the current path 
— { HOME directory -names } 


PDIM Command 
Changes the size of P/CT 
CXniaVinind OGnmc¥ men) Changes PICT relative to the 
current user coordinates 


#horizontal #vertical Does not affect current 
user coordinates 
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PERM Function 
Permutations of n objects taken m at a time 
nm— Pam 
*symb’ n —+ ’PERM(symb,n)’ 
n ’symb’ -—+ ’PERM(n,symb)’ 
‘symb,’ ‘symb,’ —+ ‘'PERM(symb,,symb,)’ 


PGDIR Command 
Purges specified directory and its contents 
‘name’ — 


PICK Command 
Copies nth object into level 1 (excluding n) 
obj, ... obj; n —> obj,... obj, obj, 


PICT Command 


Returns the name PICT to level 1 


PIXOFF Command 
Turns off a pixel in PICT 


(xy) 
{ #x #y } 


PIXON Command 
Turns on a pixel in PICT 


(xy) 
{ #x #y } 


PIX? Command 
Tests a pixel in PICT 


PKT Command 
Sends commands to server 
"contents" "type" "response" 
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PMAX Command 
Sets the upper-right plot coordinates 

(xy) — 
PMIN Command 
Sets the lower —left plot coordinates 

(xy) — 
POLAR Command 


Selects polar plot 


POS Command 
Finds a substring in a string or finds an object in a list 
"string" "substring" — n 
{list} obj — n 
PREDV Command 
Predicted dependent variable value 
x predicted — value 


PREDX Command 
Predicted independent variable value 

y —- predicted - value 
PREDY Command 


Predicted dependent variable value 
x — predicted - value 


PRLCD Command 


Prints an image of the display 


PROMPT Command 
Displays prompt and halts program 

"prompt" — 
PRST Command 


Prints the stack 


PRSTC Command 


Prints the stack in compact format 
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PRVAR Command 
Prints the name and contents of one or more variables 
‘name’ — 
:port:name — 
{ name, names... } — 


PR1 Command 
Prints the level 1 object 
object 


PURGE Command 
Purges one or more variables 

‘global’ 

{ global, global, ... } 

{ port:name, port:name,... } 

:port:name 

LID 

PICT 


PUT Command 
Replaces an element in an array or list 
{ list; } position obj { list. } 
‘name’ position obj 
[vector,] position z [vector,] 
[[matrix,]] position [[matrix.]] 
[[matrix,]] { row col } [[matrix.]] 
‘name’ { row col } 


PUTI Command 
Replaces an element in an array or list and increments the position 
{ list; } position obj { list, } position’ 
‘name’ position obj ‘name’ position’ 
[vector,] position [vector] position’ 
[[matrix,]] position z [[matrix,]] position’ 
[[matrix,]] {rowcol} z [[matrix,]] { row col }’ 
‘name’ {rowcol} x ‘name’ { rowcol }’ 


ae ee ee ee ae 
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PVARS Command 


Returns list of backup objects and library objects and the type of 
memory (or amount of memory if independent RAM) 


port — {list} "ROM" 
port — {list} "SYSRAM" 
port — { list} bytes 
PVIEW Command 


Displays P/CT with the specified coordinate or pixel at the upper — left 
corner. An empty list displays P/CT centered in the display, ready to 
scroll. 


PWRFIT Command 


Selects power curve - fitting model 


PX—C Command 
Pixel to user —unit coordinate conversion 
{#col #row} — (xy) 


—Q Command 
Converts numbers to fractional equivalent 
x —  ’a/b’ 
(xy) —  ’a/b+ce/d*i’ 
X+1.4" — 'X+7/5’ 
Note: 
The display mode (such as 2 FIX) affects the result 


—Qr Command 
—(Q after factoring out x 


x 

x 

(x,y) 

(x,y) 

(x,y) 

(x,y) 
(2.5,3.5)*X’ 


‘a/b*x’ 

‘a/b! 
’'a/b*x+c/d*x*i’ 
’'a/b*x+c/d*i’ 
’'a/b+c/d*x*i’ 
’'a/b+c/d*i’ 
*(5/2+7/2*i)*x’ 


eee ee 


Note: 
The display mode (such as 2 FIX) affects the result 
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QUAD Command 
Solves a quadratic polynomial 
*symb,' ‘global’ —+  'symb,’ 


QUOTE Command 
Returns argument expression unevaluated 

*symb’ — *symb’ 
RAD Command 


Sets Radians mode 


RAND Command 


Returns a random number 


RCEQ Command 


Recalls the current equation 


RCL Command 
Recalls the contents of a variable or backup object 
‘name’ — obj 
PICT — — grob 
:port:name —+ obj 
:port:{path name} — obj 
RCLALARM Command 
Recalls alarm from alarm list 
{ date time action repeat } 


RCLF Command 


Returns a list containing two binary integers representing 
the system and user flags 


{ #system #user } 
Note: 
The wordsize should be set to 64 bits 


RCLKEYS Command 
Lists user—key assignments. S indicates standard keys are active. 

— { obj, re.p,; ... obj, rce.p, } 

=> { S obj, re.p, ... obj, rc.p, } 
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RCLMENU Command 
Recalls number and page of active menu 
>> 


RCWS Command 
Recalls the binary integer wordsize 
_— 


RCLY Command 
Recalls the current statistics matrix 
> 


RDM Command 
Redimensions a matrix. Extra elements are dropped, missing elements 
are padded with zeros. 
[vector,] {cols } [vectors] 
[vector] { rows cols } [[matrix]] 
[[matrix]] {cols } [vector] 
[[matrix,]] { rows cols } [[matrix]] 
‘name’ {cols } 
‘name’ {rows cols } 


RDZ Command 
Sets the random number seed. Supply 0 to use the system clock. 
x —_ 


RE Function 
Returns the real part of a complex number, array, or unit object 
x —> xX 
(sy) + x 
[C-array] —+  [R-array] 
‘symb’ — *RE(symb)’ 
to 


x_unit 
RECN Command 
Receives file from remote Kermit, saved in an object named in level 1 

‘name’ — 

"name" i 
RECV Command 


Receives file from remote Kermit, saved in a sender —-named object 
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REPEAT Command 
Begins loop clause in WHILE ... REPEAT ... END 
Fo 


REPL Command 
Replaces the level 1 object onto the level 3 object at the location 
specified in level 2 
{ list} n {sublist} — { list’ } 
"string" n= “substring" — "string" 
grob (x,y) subgrob -— _— grob’ 
grob {#m#n} subgrob -— — grob’ 
PICT (x,y) subgrob — 
PICT {#x#y} subgrob — 


RES Command 
Sets the plot resolution in user -—unit or pixel intervals 


n— Interval in user-units 
#n — Interval in pixels 


RESTORE Command 
Replaces HOME directory with backup copy 


backup — 


RL Command 
Rotates left by one bit 


RLB Command 
Rotates left by one byte 
#n, 


RND Function 
Rounds fractional part of number 
z, Nn 

z ’symb’ 

*symb’ x 

*symb,’ ‘symb,’ 

x_unit n 

x_unit ‘’symb’ 

[vector,] n 

[[matrix,]] n 


22 

*RND(z,symb)’ 
*RND(symb,x)’ 
"RND(symb,,symb,)’ 
x’_unit 
*RND(x_unit,symb)’ 
[vector,] 

[[matrix.]] 


Page ng a ee 
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RNRM Command 


Computes the maximum value of the sums of the absolute values 
of all elements over all rows 
[vector] —* row-norm 
[[matrix]] —* |row-norm 
Note: 
Since a vector is considered a 1-—row matrix, RNRM returns the 
largest element in the vector. 


ROLL Command 
Moves level n+1 object to level 1 
obj, ... obj; N —+ Obj,_;,... Obj; Obj, 


ROLLD Command 
Moves the level 2 object to level n 
obj, ...obj, n —+ obj, Obj, ... obj,_; 


ROOT Command 
Finds a numerical root 
*symb’ ‘global’ guess root 
*symb’ ‘global’ { guess, guess, } root 
"symb’ ‘global’ { guess; guess, guess, } root 
«program» ‘global’ guess root 
«program» ‘global’ { guess, guess, } root 
«program» ‘global’ { guess, guess, guess, } root 


ROT Command 
Moves the level 3 object to level 1 
Objg obj, obj; —+ obj obj, objs 


RR Command 
Rotates right by one bit 


RRB Command 
Rotates right by one byte 
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RSD Command 
Computes a correction to the solution of a system of equations 
[vector B] [[matrix A]] [vector Z] — [vector B-AZ] 
[{matrix B]] [[matrix A]] [[matrix Z]] — [[matrix B-AZ]] 


R—B Command 
Real —to —binary conversion 


R—C Command 
Real-—to —-complex conversion 


x y (xy) 
[R-array,eai] [R-arrayimag] [C-array] 


R—D Command 
Radians —to —- degrees conversion 
x (180/x)x 


SAME Command 
Tests two objects for equality 

obj, obj, 
SBRK Command 


Sends serial break 


SCALE Command 
Specifies x and y scale in units per 10 pixels 

x yo 
SCATRPLOT Command 
Draws a scatter plot of the data in EDAT 


SCATTER Command 


Selects scatter plot 


SCI Command 


Sets Scientific display mode 


SCONJ Command 
Conjugates the contents of a variable 
‘name’ — 
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SDEV Command 
Computes standard deviations of the data in [DAT 

> xX 

—> — [ Xy Xp «ee Xm] 


SEND Command 
Sends object to another Kermit device 
‘local-name’ — 
{{ local-name remote—name }} — 
{ local-name, local-name,...} — 
{ { local-name, remote-name } local—name, ... } 


SERVER Command 


Selects Kermit Server mode 


SF Command 


Sets a system or user flag 


SHOW Command 
Resolves all name references or all name references except 
those in a list 
"symb,’ ‘name’ —+  ’symb,’ 
‘symb,’ {name} — "symb,’' 


SIGN J Function 
Sign of a number. Complex numbers return a unit vector in the 
direction of z. 
x <0 
x=0 
x>0 
21 
x_unit y 
*symb’ *SIGN(symb)’ 


| 0 f Function 


z sin z 
*symb’ *SIN(symb)’ 
x_pa-unit sin x 





174 Command Reference 


SINH | df Function 


Hyperbolic sine 


SINV Command 
Inverts the contents of a variable 
‘name’ 


SIZE Command 


Finds the dimensions of an object 
{ list } 
‘algebraic’ 
"string" 
[vector] 
[[matrix]] 
grob 
PICT 
unit_object 
other 


objects 
objects 
characters 

{ elements } 
{ rows cols } 
width height 
width height 
objects 


ge Re ae a Ee 


SL Command 
Shifts left by one bit 


SLB Command 
Shifts left by one byte 


SNEG Command 
Negates the contents of a variable 
‘name’ 


SQ | df Function 
Squares a number or matrix 
z 2? 
[[matrix]] [[matrix * matrix]] 
*symb’ *SQ(symb)’ 
x_unit x?_unit? 
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SR Command 
Shifts right by one bit 


SRB Command 
Shifts right by one byte 


SRECV Command 
Reads n characters from I/O port. T/F is 1 for successful receive. 
n — "string" 1/F 


START Command 
Begins START ... NEXT or START ... STEP 

start end START loop-clause NEXT 

start end START loop-clause increment STEP 


STD Command 
Sets Standard display mode 


STEP Command 
Ends FOR ... STEP or START ... STEP 
increment — 


STEQ Command 
Stores into reserved variable EQ 
obi — 


STIME Command 


Sets serial transmit/receive timeout. The valid range is 0 to 25.4 
seconds. O means there is no time limit. 


STO Command 
Stores an object into a variable 


obj name 

obj :port:name 

obj name(position) 

grob PICT 

backup port—number 
library port—number 





i ee ae 
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STOALARM Command 
Stores alarm in system alarm list 


time alarm —number 

{ date } alarm—number 

{ date time } alarm—number 

{ date time action } alarm—number 

{ date time action repeat } alarm —number 


STOF Command 


Sets the system flags or the system and user flags according to the 
value of two binary integers in a list 


#system — 
{ #system #user} — 
Note: 
The wordsize should be set to 64 bits 


STOKEYS Command 
Makes multiple user —key assignments. Including S activates standard 
key definitions. 

S 


{ obj, rc.p, ... Obj, rc.p, } 
{S obj, re.p, ... obj, re.p, } 


STO+ Command 
Storage addition (see +) 

object ‘name’ 

‘name’ object 
STO- Command 
Storage subtraction (see —) 

object ‘name’ 

‘name’ object 
STO* Command 
Storage multiplication (see *) 

object ‘name’ 

‘name’ object 
STO/ Command 
Storage division (see /) 


object ‘name’ 
‘name’ object 
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STOZ Command 
Stores into reserved variable SDAT 
obi — 

STR— Command 
Evaluates the commands defined by a string after removing the 
"" delimiters 

"string’ — 
—STR Command 
Converts an object to a string 

object —> "object" 
STWS Command 


Sets the binary integer wordsize 


SUB Command 
Extracts a portion of a list, string, or grob 
{ list } start end { sublist } 
"string" start end "substring 
grob (x4,¥1) (X2,Yo) subgrob 
grob { #x, #y,} { #x. #y2} subgrob 
PICT (x4,Y1) (XasYo) subgrob 
PICT { #x, #y,} {#%> #yo} subgrob 
SWAP Command 
Swaps the objects in levels 1 and 2 
obj, obj, 


SYSEVAL Command 


Executes a system object 


—TAG Command 


Tags an object with another object 
obj "tag" :tag:obj 
obj ‘name’ :name: obj 
obj x :x:Obj 
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TAN | 0 f Function 


Tangent 


z tanz 
*symb’ *TAN(symb)’ 
X_pa-unit tan x 


TANH | 8 f Function 
Hyperbolic tangent 


TAYLR Command 


Computes a Taylor series approximation 
*symb,’ ‘global’ degree —> 


TEXT Command 
Selects the stack display 


THEN Command 
Begins true —clause of IF, IFERR, or CASE structures 
W/E. = 
TICKS Command 
Returns time in binary integer clock ticks (8192 per second) 
= #n 

TIME Command 
Returns current time as number 

HH.MMSS 
—TIME Command 


Sets specified system time 
HH.MMSS 


TLINE Command 
Toggles pixels on a straight line 


(xy) (xsy’) 
{ #x, #y,} {#x2 #y2} 
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TMENU Command 
Displays temporary built-in or list- defined menu (see Menus) 


mm.pp — 

‘list-name’ — 

{ names and commands} — 
Note: 


TMENU does not affect the contents of the variable CST 
TOT Command 


Sums the columns in SDAT 


TRANSIO Command 
Selects character translation mode 
n 


No translation 

CR to CR/LF (default) 
Chars 128-159 
Chars 128-255 


TRN Command 


Transposes a matrix 


[[matrix,]] [[matrix.]] 
‘name’ 


TRNC Command 


Truncates number 


2 Z2 
[vector,] [vectors] 
[[matrix ,]] [[matrix,]] 
X,_unit Xo_unit 


TRUTH Command 
Selects truth plot 


TSTR Command 
Converts date and time numbers to string form 
date time — “string” 
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TVARS 


Command 


Lists the variables of specified type found in the current directory 


(see Object Types) 
type 
{ type, types ... } 
TYPE 


— 


— 


{ names } 
{ names } 


Command 


Returns the type of an object (see Object Types) 


object 


UBASE 


— 


Converts unit object to SI base units 


x 
*symb’ 
x_units 

UFACT 
Factors specified compound unit 
x y_units 


x_units; y_units, 


—UNIT 


— 


type 
Function 


X 
*UBASE(symb)’ 
y_base—-units 


Command 


x 
x’ units, * units 
21 2 3 


Command 


Combines number and unit object to create a new unit object 


x y_units 


UNTIL 


— 


x_units 


Command 


Begins test—clause of DO... UNTIL... END 


UPDIR 


Command 


Makes parent directory the current directory 


UTPC 


Upper - tail Chi— Square distribution 


d.o.f. x 


UTPF 
Upper - tail F - distribution 
d.o.f., d.of.. x 


UTPN 
Upper - tail normal distribution 
mean variance x 


Command Reference 


— 


— 


— 


Command 


utpc(d,x) 


Command 


utpf(d.o.f.;, d.o.f.5, x) 


Command 


utpn(mean, variance, x) 
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UTPT Command 
Upper - tail t— distribution 
d.o.f. x — — utpt(d.o.f.,x) 


UVAL Function 
Returns scalar portion of unit object 
we =e x 
*symb’ —+ ‘UVAL(symb)’ 
x_unit — x 
—V2 Command 
Combines two real numbers into 2—D vector or complex number 
according to flag - 19 and the current Coordinate System 
(flags -15 and - 16) 
[x y] 
[x Ay] 
(x,y) 
(x Ay ) 
—V3 Command 


Combines three real numbers into 3-D vector according to 
the current Coordinate System (flags -15 and - 16) 


xyz > [xyz] 
X Ye 2 7 [x Ay z] 
X Yo Z% + [xX Ayg Azz] 
VAR Command 
Variances of XDAT data in columns specified by COLE 
> *xX 
— — [ Xy Xp oe Xm] 
VARS Command 
Returns list of variables in the current directory 
—_ { names } 


VTYPE Command 


Returns the type of an object in the named variable, or —1 if the 
variable is nonexistent (see Object Types) 
‘name’ — __ type 
:port:name — _ type 
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Vv— Command 
Separates a 2 or 3 element vector. If there are more than 3 elements, 
the current Coordinate System (flags -15 and - 16) is ignored. 
[xy] 
[ x, 4Ye] 
[xyz] 
[ x, AY z ] 
[ x, AY Azzy] 
(xy ) 
(x, Ay ) 
[X1 Xo --- X_] 
WAIT Command 
Pauses program execution or waits for a key 


seconds — 
o- rc.p Doesn't update menu 
-1 —- rc.p Displays current menu 


de ods A Se 


WHILE Command 
Begins WHILE ... REPEAT ... END 
WHILE test-clause REPEAT loop-clause END 


WSLOG Command 


Returns four strings indicating the time, date, and source of the 
four most recent system halts (see System Operations) 


— "string," "string," "strings" "string," 


XCOL Command 
Specifies [DAT column as the independent variable 
x-column — 


XMIT Command 
Sends string through I/O port without Kermit 

"string" — 1 

"string" — "unsent string" O 
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XOR Function 
Logical or binary XOR 

#n, #no 

x y 

x ‘symb’ 

"symb’ x 

‘symb,’ ‘symb,’ 

"string," "string," 


#Nn3 

T/F 

"x XOR symb’ 
"symb XOR x’ 
"*symb, XOR symb,’ 
"string," 


ee ee 


Note: 
String arguments must have the same length 


XPON Function 
Returns the exponent of a number 
x n 
*symb’ *XPON(symb)’ 


XRNG Command 
Specifies x-axis plotting range 
Xmin %max 
XROOT Function 
Returns x'" root of y 
y x 
y X_pa-unit 
1 
Vy_unit* 
*XROOT(symb,y)’ 
*XROOT(x,symb)’ 
*XROOT(symb,,symb,)’ 
y’_unit’ 
*XROOT(x_pa-unit,symb,)’ 
*XROOT(symb,y_unit)’ 
YCOL Command 
Specifies a EDAT column as the dependent variable 
y-column — 


YRNG Command 


Specifies y-axis plotting range 


y_unit x 
y ‘symb’ 
‘symb’ x 
*symb,’ ‘symb,’ 
y_pa-unit x_unit 
"symb,’ x_pa-unit 


Pek ee be he ok, “det 


y_unit ‘symb’ 


Ymin Ymax ie 
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*H Command 
Adjusts the height of a plot. Enlarges (zooms out) if factor > 1. 
factor — 


*W Command 


Adjusts the width of a plot. Eniarges (zooms out) if factor > 1. 
factor — 


J | af Function 


Square root 


z- sqrt z 


‘symb’ — 'V (symb)’ 
x_unit — x _unit® 


J 8 f Function 
Integral 
lower-—limit upper-—limit ‘integrand’ ‘name’ —- integral 
*J(lower—-limit, upper -—limit, integrand, name)’ 
Notes: 
1) name is the variable of integration. 
2) Set Numerical Results mode (flag -3) to perform a numerical 
integration on the stack. 
3) The display mode (such as 2 FIX) specifies the accuracy factor for 
numerical integration, and the uncertainty of integration is 
stored in reserved variable IERR. 
fo) d f Function 
Derivative 
‘symb,’ ‘name’ — *symb,’ Complete 
’@name (expression)’ Stepwise 
Note: 
name is the variable of differentiation. 


™ d Function 
Symbolic constant x 


x do Function 
Summation 
*summation-index’ initial-value final-value ‘summand’ —> sum 
*Z(summation — index = initial —value,final -—value, summand)’ 
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SLINE Command 
Returns best-fit line for data in [DAT with values for a and b filled in 
Linear model — "at+b*X’ 
Logarithmic model —+  ’a+b*LN(X)’ 
Exponential model —+  ’a*EXP(b*X)’ 
Power model — ‘a*X*b’ 
=X Command 
Sum of data of data in independent XDAT column 
— 


uX*2 Command 
Sum of squares of data in independent ZDAT column 
> 


LY Command 


Sum of data in dependent XDAT column 


LY*2 Command 


Sum of squares of data in dependent ZDAT column 
— xy? 


DoX*Y Command 


Sum of products of data in independent and dependent ZDAT columns 
—> XX; 


“+ Command 
Appends one or more data points to SDAT 


x 
[vector] 
[[matrix]] 


ya Command 
Deletes last row from ZDAT 


x 
[vector] 
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< 
Less -—than comparison 
x y 
x y_pa-unit 
xX _pa-unit y 
x_unit, y_unit, 
x ‘symb’ 
*symb’ x 
"symb’ x_unit 
x_unit ‘symb’ 
"symb,’ ‘symb,’ 
:tag:object object 
object :tag:object 
object object 
Notes: 


a Cs es ae eae i a 


x<y (T/F) 
T/F 

T/F 

T/F 

*x<symb’ 
*symb <x’ 
"symb <x_unit’ 
’x_unit>symb’ 
*symb,<symb,’ 
T/F 

T/F 

T/F 


1) Units must be dimensionally consistent 
2) Tags are dropped before the comparison 


> 
Greater -than comparison 
x y 
x y_pa-unit 
X_pa-unit y 
x_unit, y_unit, 
x ‘symb’ 
*symb’ x 
x_unit ‘symb’ 
*symb,’ ‘symb,’ 


"symb’ x_unit 


:‘tag:object object 
object :tag:object 
object object 
Notes: 


ee ee ae a ee a a 


x>y (T/F) 
T/F 

T/F 

T/F 

*x>symb’ 
*symb >x’ 
*x_unit >symb’ 
*symb,>symb,’ 
"symb >x_unit’ 
T/F 

T/F 

T/F 


1) Units must be dimensionally consistent 
2) Tags are dropped before the comparison 
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< 


Less —than-or-—equal comparison 


x y 

x y_pa-unit 
X_pa-unit y 
x_unit, y_unit, 


x ’symb’ 
*symb’ x 
"symb’ x_unit 
x_unit ‘symb’ 
"symb,’ ‘symb,’ 
:tag:object object 
object :tag:object 
object object 
Notes: 


es a Se A ee oe Pe ee oe 


x<y (T/F) 
T/F 

T/F 

T/F 

*x <symb’ 
*symb < x’ 
"symb < x_unit’ 
*x_unit < symb’ 
“symb, < symb,’ 
T/F 

T/F 

T/F 


1) Units must be dimensionally consistent 
2) Tags are dropped before the comparison 


> 


Greater —-than-—or-—equal comparison 


x y 

x y_pa-unit 

X_pa-unit y 

x_unit, y_unit, 

x ‘*symb’ 

‘symb’ x 

‘symb’ x_unit 

x_unit ‘symb' 

*symb,’ ‘symb,’ 

:tag:object object 

object :tag:object 

object object 
Notes: 


es a is re ge ae oe ae 


x>y (T/F) 
T/F 

T/F 

T/F 

*x > symb’ 
*symb > x’ 
“symb > x_unit’ 
*x_unit > symb’ 
*symb, > symb,’ 
T/F 

T/F 

T/F 


1) Units must be dimensionally consistent 
2) Tags are dropped before the comparison 
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Function 


Function 
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7 Function 


Not — equal comparison 


x y —- x#y (T/F) 
x z —-~ T/F 
zx — “T/F 
x y_pa-unit — T/F 
x pa-unit y — T1/F 
x_unit; y_unit, —>+ T/F 
z ‘symb’ — "2 #Ssymb’ 
*symb’ z — ~~ 'symb #2’ 
"symb’ x_unit —+ = ‘symb #x_unit’ 
x_unit ’symb’ — = ’x_unit # symb’ 
*symb,’ ‘symb,’ —> ~ 'symb, #symb,’ 
:tag:object object — # T/F 
object :tag:object — T/F 
object object — #£T/F 


Notes: 

1) Units must be dimensionally consistent 
2) Real - complex comparisons assume the imaginary part is 0 
3) Tags are dropped before the comparison 
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Logical equality comparison 
x 
x 
z 
x y_pa-unit 
x _pa-unit y 
x_unit,; y_unit, 
z ‘symb’ 
"symb’ z 
"symb’ x_unit 
x_unit ‘symb’ 
*symb’ x_unit 
*symb,’ ‘symb,’ 
:tag:object object 
object :tag:object 
object object 
Notes: 


par 
—_s 
— 
>> 
— 
— 
> 
—> 
_—_ 
> 
— 
— 
Sd 
> 
— 


x==y (T/F) 

T/F 

T/F 

T/F 

T/F 

T/F 

‘'Z==symb’ 
*symb = =2’ 

T/F 

*x_unit == symb’ 
*symb == x_unit’ 
*symb, = =symb,’ 
T/F 

T/F 

T/F 


1) Units must be dimensionally consistent 


2) Real - complex comparisons assume the imaginary part is 0 


3) Tags are dropped before the comparison 


— 
Assigns local variable (s) 
Obj, ... obj, 
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— 


Function 


Command 
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+ 
Adds two objects 
Z,; Zo 
#n m 
n #m 
#n #m 
x_unit y_unit 
x y_pa-unit 
xX _pa-unit y 
*symb,’ ’symb,’ 
z ‘symb’ 
*symb’ z 
"symb’ x_unit 
x_unit ‘symb’ 
[vector,] [vectors] 
[[matrix,]] [[matrix,]] 
grob, grob, 
{list;}  {list.} 
"abc" "def" 
{ list } object 
object { list } 
"string" object 
object "string" 
Notes: 


1) Grobs must have identical dimensions. 


_ 
—_ 
_ 
> 
_— 
> 
— 
> 
—> 
> 
— 
— 
_—_ 
— 
— 
— 
— 
> 
— 
—)> 
— 


| 0 Function 


Z,+Zo 

#n+m 

#n+m 

#n+m 
x+y_unit 
x+y_pa-unit 
x+y 

*symb, + symb,’ 
'z+symb' 
*symb+z’ 
"symb+x_unit’ 
’x_unit+symb’ 
[vector, + vector,] 
[[matrix, + matrix,]] 
grob, 

{list, listp} 
“abcdef" 

{ list object } 

{ object list } 
"stringobject" 
“objectstring" 


2) -STR is executed on objects added to strings. 
3) Units must be dimensionally consistent 
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Subtracts two objects 
21 22 
#n m 
n #m 
#n #m 
x_unit y_unit 
xX y_pa-unit 
x _pa-unit y 
z ’symb’ 
*symb’ z 
"symb,’ ‘symb,' 
*symb’ x_unit 
x_unit *symb’ 
[vector,] [vector,] 
[[matrix,]] [[matrix,]] 


Note: 


Units must be dimensionally consistent 


* 
Multiplies two objects 

Z, Zo 

#n #m 

#n m 

n #m 

[vector] z 

z [vector] 

[[matrix]] [vector] 

[{matrix]] [[matrix]] 

z ‘symb’ 

‘symb’ z 

*symb,’ ’symb,’ 

x_unit, y_unit, 

x y_unit 

x_unit y 

x_unit *symb’ 

*symb’ x_unit 
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Aig Goo ae ae ae Oe ae a 


ie i ae is le as ee cae ae Oe ae Mi at 


| 6 Function 


21 — 22 

#n-m 

#n-m 

#n-m 

x-y_unit 
x-y_pa-unit 

x-y 

"z-symb’ 
*symb—z’ 

*symb, — symb,’ 
*symb —x_unit’ 
*x_unit-symb’ 
[vector, -vectors] 
[[matrix, —-matrixs]] 


| 8 Function 


Z4*Zo 

#n*m 

#n*m 

#n*m 

[vector*z] 
[vector*z] 
[matrix*vector] 
[[matrix* matrix]] 
’z*symb’ 
*symb*z’ 
*(symb,)* (symb,)' 
x*y_ units 
x*y_unit 
x*y_unit 
*(x_unit)*(symb)’ 
*(symb)* (x_unit)’ 
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Divides two objects 
21 22 
n #m 
#n m 
#n #m 
[vector] z 
[vector] [[matrix]] 
z ’symb’ 
*symb’ z 
*symb,’ ‘symb,’ 
x_unit, y_unit, 
x y_unit 
x_unit y 
x_unit *symb’ 
"symb’ x_unit 


n 


Raises a number to a power 
Z; Zo 
z ‘symb’ 
*symb’ z 
*symb,’ ‘symb,’ 
x_unit y_pa-unit 
xX y_pa-unit 
x_unit y 
x_unit ‘symb’ 
*symb’ x_unit 

! 


Factorial or gamma function 


n 
x 
*symb’ 


| (where) 
Substitutes symbolics for names in a symbolic expression 


'syMboiq’ 


Ee ke A ae ae ae ae a a a a 


I Fa ae Oe ae 


| 0 Function 


z, / 22 

#n/m 

#n/m 

#n/m 

[vector/z] 
[[vector/matrix]] 
’z/(symb)’ 
’(symb)/z’ 
‘(symb,)/(symb,)’ 
x/y_unit,/unit, 
x/y_1/unit 
x/y_unit 
*(x_unit)/(symb)’ 
*(symb) /(x_unit)’ 


| 0 f Function 


Z1~ 22 

’z*(symb)’ 
*(symb)*z’ 
'(symb,)*(symb,)’ 
x*y_unit 

x 

x*y_unit*y 
’(x_unit)*(symb)’ 
’(symb)*(x_unit)’ 


Function 
n! 


T(x +1) 
*(symb)!’ 


0 Function 


{ name, symb, ...name, symb, } — ‘symD, ey’ 


z {name, symb,...name, symb, } — z 


*symboj)q| (name,=symb,, .. 
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% 
Percent 
x y 
x ‘*symb’ 
*symb’ x 
‘symb,’ ‘symb,’ 
x_unit y 
x_unit ‘symb’ 
"symb’ x_unit 
x y_unit 


%CH 


Percent change 
x y 
x ‘symb’ 
*symb’ x 
‘symb,’ ’symb,’ 
x_unit y_unit 
xX y_pa-unit 
X_pa-unit y 
x_unit ‘symb’ 
‘symb’ x_unit 

Note: 


Units must be dimensionally consistent 


%T 
Percent total 

x y 
x ‘symb’ 
*symb’ x 
"symb, 


‘symb,’ 
x_unit y_unit 

x y_pa-unit 
X_pa-unit y 
x_unit  ‘symb’ 
‘symb’ x_unit 


Note: 


Units must be dimensionally consistent 
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A Ea ae ea ee 


dod eb ede head 


i ee ee Oa a a Ka 


Function 


xy/100 
*%(x,symb)’ 
*%(symb,x)’ 
"%(symb,,symb,)’ 
xy/100_unit 
"%(x_unit,symb)’ 
*%(symb,x_unit)’ 
xy/100_unit 


Function 


100(y-x)/x 
*%CH(x,symb)’ 
*%CH(symb,x)’ 
*%CH(symb,,symb,)’ 
100(y-x)/x 
100(y’ -—x) /x 
100(y-x’)/x’ 
°%CH(x_unit,symb)’ 
°%CH(symb,x_unit)’ 


Function 


100y/x 
*%T(x,symb)’ 
*%T(symb,x)’ 
'°%T(symb,,symb.)’ 
100y/x 

100y’/x 

100y/x’ 
"%T(x_unit,symb)’ 
'%T(symb,x_unit)’ 
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Alpha Keyboard 


a b peo Ad 6 e e f 6 


Ca] (a) (6) (2) fe) 
i co j | 
Oo) oe) 


iH) Oe) fe) fel 
3) 2 Wy) ow) 


i 
(amen | (Y) (Z) eal &) 


etc. () 


CONT OFF = 


fox) Co] Ce) [ee] Ce 


Alpha Keyboard 
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